Amazon CloudWatch による Amazon Chime SDK のモニタリング - Amazon Chime SDK

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon CloudWatch による Amazon Chime SDK のモニタリング

CloudWatch を使用して Amazon Chime SDK をモニタリングできます。CloudWatch は、raw データを収集して、それを読み取り可能なほぼリアルタイムのメトリクスに変換します。これらの統計は 15 か月間保持されるため、履歴情報にアクセスしてウェブアプリケーションまたはサービスの動作をより的確に把握できます。また、特定のしきい値を監視するアラームを設定し、これらのしきい値に達したときに通知を送信したりアクションを実行したりできます。詳細については、「Amazon CloudWatch ユーザーガイド」を参照してください。

Amazon Chime SDK の CloudWatch メトリクス

Amazon Chime SDK は、次のメトリクスを CloudWatch に送信します。Amazon Chime SDK は、呼び出しの期間中、メトリクスを 1 分に 1 回送信し、ここにリストされているすべてのメトリクスを送信します。

AWS/ChimeVoiceConnector 名前空間には、 AWS アカウントと Amazon Chime SDK Voice Connector に割り当てられた電話番号に関する以下のメトリクスが含まれます。

注記

SDK は、呼び出し中にパケットロス値を 1 分に 1 回送信します。損失値は、呼び出しの期間中累積されます。例えば、パケット損失が 11:01 に発生した場合、その損失値は呼び出しの残りの分だけ引き継がれます。呼び出しの終了時に、単一のパケット損失メトリクスを受け取ります。

メトリクス 説明

InboundCallAttempts

試行された受信通話の数。

単位: 回

InboundCallFailures

受信通話の失敗回数。

単位: 回

InboundCallsAnswered

応答された受信通話の数。

単位: 回

InboundCallsActive

現在アクティブな受信通話の数。

単位: カウント

OutboundCallAttempts

試行された発信通話の数。

単位: カウント

OutboundCallFailures

発信通話の失敗回数。

単位: カウント

OutboundCallsAnswered

応答された発信通話の数。

単位: カウント

OutboundCallsActive

現在アクティブな発信通話の数。

単位: カウント

Throttles

通話の試行時にアカウントがスロットルされる回数。

単位: カウント

Sip1xxCodes

1xx レベルのステータスコードを持つ SIP メッセージの数。

単位: カウント

Sip2xxCodes

2xx レベルのステータスコードを持つ SIP メッセージの数。

単位: カウント

Sip3xxCodes

3xx レベルのステータスコードを持つ SIP メッセージの数。

単位: カウント

Sip4xxCodes

4xx レベルのステータスコードを持つ SIP メッセージの数。

単位: カウント

Sip5xxCodes

5xx レベルのステータスコードを持つ SIP メッセージの数。

単位: カウント

Sip6xxCodes

6xx レベルのステータスコードを持つ SIP メッセージの数。

単位: カウント

CustomerToVcRtpPackets

顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信された RTP パケットの数。

単位: カウント

CustomerToVcRtpBytes

RTP パケットで顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信されたバイト数。

単位: カウント

CustomerToVcRtcpPackets

顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信された RTCP パケットの数。

単位: カウント

CustomerToVcRtcpBytes

RTCP パケットで顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信されたバイト数。

単位: カウント

CustomerToVcPacketsLost

顧客から Amazon Chime SDK Voice Connector インフラストラクチャへの転送中に失われたパケットの数。値は、通話が終了するまで 1 分ごとに送信されます。値の数は累積的です。

単位: カウント

CustomerToVcJitter

顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信されたパケットの平均ジッター。

単位: マイクロ秒

VcToCustomerRtpPackets

Amazon Chime SDK Voice Connector インフラストラクチャからお客様に送信された RTP パケットの数。

単位: カウント

VcToCustomerRtpBytes

Amazon Chime SDK Voice Connector インフラストラクチャから RTP パケットで顧客に送信されたバイト数。

単位: カウント

VcToCustomerRtcpPackets

Amazon Chime SDK Voice Connector インフラストラクチャからお客様に送信された RTCP パケットの数。

単位: カウント

VcToCustomerRtcpBytes

Amazon Chime SDK Voice Connector インフラストラクチャから RTCP パケットでお客様に送信されたバイト数。

単位: カウント

VcToCustomerPacketsLost

Amazon Chime SDK Voice Connector インフラストラクチャから顧客への転送中に失われたパケットの数。値は、通話が終了するまで 1 分ごとに送信されます。値の数は累積的です。

単位: カウント

VcToCustomerJitter

Amazon Chime SDK Voice Connector インフラストラクチャから顧客に送信されたパケットの平均ジッター。

単位: マイクロ秒

RTTBetweenVcAndCustomer

顧客と Amazon Chime SDK Voice Connector インフラストラクチャ間の平均往復時間。

単位: マイクロ秒

MOSBetweenVcAndCustomer

顧客と Amazon Chime SDK Voice Connector インフラストラクチャ間の音声ストリームに関連する推定平均オポインションスコア (MOS)。

単位: 1.0~4.4 のスコア。スコアが高いほど、認識されるオーディオ品質が向上します。

RemoteToVcRtpPackets

リモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャに送信された RTP パケットの数。

単位: カウント

RemoteToVcRtpBytes

リモートエンドから RTP パケットで Amazon Chime SDK Voice Connector インフラストラクチャに送信されたバイト数。

単位: カウント

RemoteToVcRtcpPackets

リモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャに送信された RTCP パケットの数。

単位: カウント

RemoteToVcRtcpBytes

RTCP パケットでリモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャに送信されたバイト数。

単位: カウント

RemoteToVcPacketsLost

リモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャへの転送中に失われたパケットの数。値は、通話が終了するまで 1 分ごとに送信されます。値の数は累積的です。

単位: カウント

RemoteToVcJitter

リモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャに送信されたパケットの平均ジッター。

単位: マイクロ秒

VcToRemoteRtpPackets

Amazon Chime SDK Voice Connector インフラストラクチャからリモートエンドに送信された RTP パケットの数。

単位: カウント

VcToRemoteRtpBytes

Amazon Chime SDK Voice Connector インフラストラクチャから RTP パケットでリモートエンドに送信されたバイト数。

単位: カウント

VcToRemoteRtcpPackets

Amazon Chime SDK Voice Connector インフラストラクチャからリモートエンドに送信された RTCP パケットの数。

単位: カウント

VcToRemoteRtcpBytes

Amazon Chime SDK Voice Connector インフラストラクチャから RTCP パケットのリモートエンドに送信されたバイト数。

単位: カウント

VcToRemotePacketsLost

Amazon Chime SDK Voice Connector インフラストラクチャからリモートエンドへの転送中に失われたパケットの数。値は、通話が終了するまで 1 分ごとに送信されます。値の数は累積的です。

単位: カウント

VcToRemoteJitter

Amazon Chime SDK Voice Connector インフラストラクチャからリモートエンドに送信されたパケットの平均ジッター。

単位: マイクロ秒

RTTBetweenVcAndRemote

リモートエンドと Amazon Chime SDK Voice Connector インフラストラクチャ間の平均ラウンドトリップ時間。

単位: マイクロ秒

MOSBetweenVcAndRemote

リモートエンドと Amazon Chime SDK Voice Connector インフラストラクチャ間の音声ストリームに関連する推定平均オリジンスコア (MOS)。

単位: 単位: 1.0~4.4 のスコア。スコアが高いほど、認識されるオーディオ品質が向上します。

Amazon Chime SDK の CloudWatch ディメンション

Amazon Chime SDK で使用できる CloudWatch ディメンションを以下に示します。

ディメンション 説明

VoiceConnectorId

メトリクスを表示する Amazon Chime SDK Voice Connector の識別子。

Region

イベントに関連付けられた AWS リージョン。

Amazon Chime SDK の CloudWatch ログ

CloudWatch Logs にメトリクスを送信するように Amazon Chime SDK Voice Connector を設定できます。これを行うと、それらの Voice Connector のメディア品質メトリクスログを受信することもできます。

Amazon Chime SDK は、詳細なメトリクスを 1 分に 1 回送信します。Amazon Chime SDK は、設定された Voice Connector で行われたすべての通話についてそれらを送信し、ユーザーに代わって作成した CloudWatch Logs ロググループに送信します。

ロググループ名は、 という形式を使用します/aws/ChimeVoiceConnectorLogs/${VoiceConnectorID}

メトリクスを送信するように Voice Connector を設定する方法の詳細については、「」を参照してくださいAmazon Chime SDK Voice Connector 設定の編集

注記

パケット損失メトリクスは、通話中に累積されます。例えば、パケット損失が 11:01 に発生した場合、その損失値は呼び出しの残りの分だけ引き継がれます。呼び出しの終了時に、単一のパケット損失メトリクスを受け取ります。

Amazon Chime SDK には、JSON 形式のログに次のフィールドが含まれています。

フィールド 説明

voice_connector_id

通話中の Amazon Chime SDK Voice Connector ID。

event_timestamp

メトリクスが出力された時刻 (ミリ秒単位)。UNIX エポック (1970 年 1 月 1 日の午前 0 時) からの経過時間 (UTC) で表示されます。

call_id

トランザクション ID に対応します。

from_sip_user

呼び出しの開始ユーザー。

from_country

呼び出しの発信国。

to_sip_user

呼び出しの受信ユーザー。

to_country

呼び出しの受信国。

endpoint_id

呼び出しのもう一方のエンドポイントを示す不透明な識別子。CloudWatch Logs Insights と組み合わせて使用します。詳細については、Amazon CloudWatch Logs ユーザーガイドの「CloudWatch Logs Insights を使用したログデータの分析」を参照してください。

aws_region

呼び出しの AWS リージョン。

cust2vc_rtp_packets

顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信された RTP パケットの数。

cust2vc_rtp_bytes

RTP パケットで顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信されたバイト数。

cust2vc_rtcp_packets

顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信された RTCP パケットの数。

cust2vc_rtcp_bytes

RTCP パケットで顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信されたバイト数。

cust2vc_packets_lost

顧客から Amazon Chime SDK Voice Connector インフラストラクチャへの転送中に失われたパケットの数。値は、通話が終了するまで 1 分ごとに送信されます。値の数は累積的です。

cust2vc_jitter

顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信されたパケットの平均ジッター。

vc2cust_rtp_packets

Amazon Chime SDK Voice Connector インフラストラクチャからお客様に送信された RTP パケットの数。

vc2cust_rtp_bytes

Amazon Chime SDK Voice Connector インフラストラクチャから RTP パケットで顧客に送信されたバイト数。

vc2cust_rtcp_packets

Amazon Chime SDK Voice Connector インフラストラクチャからお客様に送信された RTCP パケットの数。

vc2cust_rtcp_bytes

Amazon Chime SDK Voice Connector インフラストラクチャから RTCP パケットでお客様に送信されたバイト数。

vc2cust_packets_lost

Amazon Chime SDK Voice Connector インフラストラクチャから顧客への転送中に失われたパケットの数。値は、通話が終了するまで 1 分ごとに送信されます。値の数は累積的です。

vc2cust_jitter

Amazon Chime SDK Voice Connector インフラストラクチャから顧客に送信されたパケットの平均ジッター。

rtt_btwn_vc_and_cust

顧客と Amazon Chime SDK Voice Connector インフラストラクチャ間の平均往復時間。

mos_btwn_vc_and_cust

顧客と Amazon Chime SDK Voice Connector インフラストラクチャ間の音声ストリームに関連する推定平均オポインションスコア (MOS)。

rem2vc_rtp_packets

リモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャに送信された RTP パケットの数。

rem2vc_rtp_bytes

リモートエンドから RTP パケットで Amazon Chime SDK Voice Connector インフラストラクチャに送信されたバイト数。

rem2vc_rtcp_packets

リモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャに送信された RTCP パケットの数。

rem2vc_rtcp_bytes

RTCP パケットでリモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャに送信されたバイト数。

rem2vc_packets_lost

リモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャへの転送中に失われたパケットの数。値は、通話が終了するまで 1 分ごとに送信されます。値の数は累積的です。

rem2vc_jitter

リモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャに送信されたパケットの平均ジッター。

vc2rem_rtp_packets

Amazon Chime SDK Voice Connector インフラストラクチャからリモートエンドに送信された RTP パケットの数。

vc2rem_rtp_bytes

Amazon Chime SDK Voice Connector インフラストラクチャから RTP パケットでリモートエンドに送信されたバイト数。

vc2rem_rtcp_packets

Amazon Chime SDK Voice Connector インフラストラクチャからリモートエンドに送信された RTCP パケットの数。

vc2rem_rtcp_bytes

Amazon Chime SDK Voice Connector インフラストラクチャから RTCP パケットのリモートエンドに送信されたバイト数。

vc2rem_packets_lost

Amazon Chime SDK Voice Connector インフラストラクチャからリモートエンドへの転送中に失われたパケットの数。値は、通話が終了するまで 1 分ごとに送信されます。値の数は累積的です。

vc2rem_jitter

Amazon Chime SDK Voice Connector インフラストラクチャからリモートエンドに送信されたパケットの平均ジッター。

rtt_btwn_vc_and_rem

リモートエンドと Amazon Chime SDK Voice Connector インフラストラクチャ間の平均ラウンドトリップ時間。

mos_btwn_vc_and_rem

リモートエンドと Amazon Chime SDK Voice Connector インフラストラクチャ間の音声ストリームに関連する推定平均オリジンスコア (MOS)。

SIP メッセージログ

Amazon Chime SDK Voice Connector の SIP メッセージログの受信を選択できます。これを行うと、Amazon Chime SDK はインバウンドおよびアウトバウンドの SIP メッセージをキャプチャし、作成された CloudWatch Logs ロググループに送信します。ロググループ名は /aws/ChimeVoiceConnectorSipMessages/${VoiceConnectorID} です。以下のフィールドが JSON 形式でログに含まれます。

フィールド 説明

voice_connector_id

Amazon Chime SDK Voice Connector ID。

aws_region

イベントに関連付けられた AWS リージョン。

event_timestamp

メッセージがキャプチャされた時刻 (ミリ秒単位)。UNIX エポック (1970 年 1 月 1 日の午前 0 時) からの経過時間 (UTC) で表示されます。

call_id

Amazon Chime SDK Voice Connector コール ID。

sip_message

キャプチャされた完全な SIP メッセージ。