この記事は英語の原文を日本語に翻訳したものです。原文: https://opentelemetry.io/docs/specs/semconv/dotnet/dotnet-signalr-metrics/

翻訳元: open-telemetry/semantic-conventions v1.44.0(コミット e10a930

SignalRサーバーメトリクスに関するセマンティック規約

ステータス: Stable

この記事では、.NETのコンポーネントとランタイムが発行するSignalRメトリクスに関するセマンティック規約を定義します。

メトリクス: signalr.server.connection.duration

このメトリクスは、[ 0.01, 0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 30, 60, 120, 300 ]ExplicitBucketBoundaries advisoryパラメータを指定すべきです(SHOULD)。

NameInstrument TypeUnit (UCUM)DescriptionStabilityEntity Associations
signalr.server.connection.durationHistogramsサーバー上の接続の持続時間。[1]Stable

[1]: Meterの名前: Microsoft.AspNetCore.Http.Connections; 追加されたバージョン: ASP.NET Core 8.0

Attributes:

KeyStabilityRequirement LevelValue TypeDescriptionExample Values
signalr.connection.statusStableRecommendedstringSignalRのHTTP接続のクロージャステータス。app_shutdown; timeout
signalr.transportStableRecommendedstringSignalRのトランスポート種別web_sockets; long_polling

signalr.connection.statusには、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません(MUST)。そうでない場合は、独自の値を使用してもかまいません(MAY)。

ValueDescriptionStability
app_shutdownアプリケーションがシャットダウン中であるため、接続がクローズされました。Stable
normal_closure接続が正常にクローズされました。Stable
timeoutタイムアウトにより接続がクローズされました。Stable

signalr.transportには、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません(MUST)。そうでない場合は、独自の値を使用してもかまいません(MAY)。

ValueDescriptionStability
long_pollingLongPollingプロトコルStable
server_sent_eventsServerSentEventsプロトコルStable
web_socketsWebSocketsプロトコルStable

メトリクス: signalr.server.active_connections

NameInstrument TypeUnit (UCUM)DescriptionStabilityEntity Associations
signalr.server.active_connectionsUpDownCounter{connection}サーバー上で現在アクティブな接続数。[1]Stable

[1]: Meterの名前: Microsoft.AspNetCore.Http.Connections; 追加されたバージョン: ASP.NET Core 8.0

Attributes:

KeyStabilityRequirement LevelValue TypeDescriptionExample Values
signalr.connection.statusStableRecommendedstringSignalRのHTTP接続のクロージャステータス。app_shutdown; timeout
signalr.transportStableRecommendedstringSignalRのトランスポート種別web_sockets; long_polling

signalr.connection.statusには、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません(MUST)。そうでない場合は、独自の値を使用してもかまいません(MAY)。

ValueDescriptionStability
app_shutdownアプリケーションがシャットダウン中であるため、接続がクローズされました。Stable
normal_closure接続が正常にクローズされました。Stable
timeoutタイムアウトにより接続がクローズされました。Stable

signalr.transportには、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません(MUST)。そうでない場合は、独自の値を使用してもかまいません(MAY)。

ValueDescriptionStability
long_pollingLongPollingプロトコルStable
server_sent_eventsServerSentEventsプロトコルStable
web_socketsWebSocketsプロトコルStable