翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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 に発生した場合、その損失値は呼び出しの残りの分だけ引き継がれます。呼び出しの終了時に、単一のパケット損失メトリクスを受け取ります。
メトリクス | 説明 |
---|---|
|
試行された受信通話の数。 単位: 回 |
|
受信通話の失敗回数。 単位: 回 |
|
応答された受信通話の数。 単位: 回 |
|
現在アクティブな受信通話の数。 単位: カウント |
|
試行された発信通話の数。 単位: カウント |
|
発信通話の失敗回数。 単位: カウント |
|
応答された発信通話の数。 単位: カウント |
|
現在アクティブな発信通話の数。 単位: カウント |
|
通話の試行時にアカウントがスロットルされる回数。 単位: カウント |
|
1xx レベルのステータスコードを持つ SIP メッセージの数。 単位: カウント |
|
2xx レベルのステータスコードを持つ SIP メッセージの数。 単位: カウント |
|
3xx レベルのステータスコードを持つ SIP メッセージの数。 単位: カウント |
|
4xx レベルのステータスコードを持つ SIP メッセージの数。 単位: カウント |
|
5xx レベルのステータスコードを持つ SIP メッセージの数。 単位: カウント |
|
6xx レベルのステータスコードを持つ SIP メッセージの数。 単位: カウント |
|
顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信された RTP パケットの数。 単位: カウント |
|
RTP パケットで顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信されたバイト数。 単位: カウント |
|
顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信された RTCP パケットの数。 単位: カウント |
|
RTCP パケットで顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信されたバイト数。 単位: カウント |
|
顧客から Amazon Chime SDK Voice Connector インフラストラクチャへの転送中に失われたパケットの数。値は、通話が終了するまで 1 分ごとに送信されます。値の数は累積的です。 単位: カウント |
|
顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信されたパケットの平均ジッター。 単位: マイクロ秒 |
|
Amazon Chime SDK Voice Connector インフラストラクチャからお客様に送信された RTP パケットの数。 単位: カウント |
|
Amazon Chime SDK Voice Connector インフラストラクチャから RTP パケットで顧客に送信されたバイト数。 単位: カウント |
|
Amazon Chime SDK Voice Connector インフラストラクチャからお客様に送信された RTCP パケットの数。 単位: カウント |
|
Amazon Chime SDK Voice Connector インフラストラクチャから RTCP パケットでお客様に送信されたバイト数。 単位: カウント |
|
Amazon Chime SDK Voice Connector インフラストラクチャから顧客への転送中に失われたパケットの数。値は、通話が終了するまで 1 分ごとに送信されます。値の数は累積的です。 単位: カウント |
|
Amazon Chime SDK Voice Connector インフラストラクチャから顧客に送信されたパケットの平均ジッター。 単位: マイクロ秒 |
|
顧客と Amazon Chime SDK Voice Connector インフラストラクチャ間の平均往復時間。 単位: マイクロ秒 |
|
顧客と Amazon Chime SDK Voice Connector インフラストラクチャ間の音声ストリームに関連する推定平均オポインションスコア (MOS)。 単位: 1.0~4.4 のスコア。スコアが高いほど、認識されるオーディオ品質が向上します。 |
|
リモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャに送信された RTP パケットの数。 単位: カウント |
|
リモートエンドから RTP パケットで Amazon Chime SDK Voice Connector インフラストラクチャに送信されたバイト数。 単位: カウント |
|
リモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャに送信された RTCP パケットの数。 単位: カウント |
|
RTCP パケットでリモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャに送信されたバイト数。 単位: カウント |
|
リモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャへの転送中に失われたパケットの数。値は、通話が終了するまで 1 分ごとに送信されます。値の数は累積的です。 単位: カウント |
|
リモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャに送信されたパケットの平均ジッター。 単位: マイクロ秒 |
|
Amazon Chime SDK Voice Connector インフラストラクチャからリモートエンドに送信された RTP パケットの数。 単位: カウント |
|
Amazon Chime SDK Voice Connector インフラストラクチャから RTP パケットでリモートエンドに送信されたバイト数。 単位: カウント |
|
Amazon Chime SDK Voice Connector インフラストラクチャからリモートエンドに送信された RTCP パケットの数。 単位: カウント |
|
Amazon Chime SDK Voice Connector インフラストラクチャから RTCP パケットのリモートエンドに送信されたバイト数。 単位: カウント |
|
Amazon Chime SDK Voice Connector インフラストラクチャからリモートエンドへの転送中に失われたパケットの数。値は、通話が終了するまで 1 分ごとに送信されます。値の数は累積的です。 単位: カウント |
|
Amazon Chime SDK Voice Connector インフラストラクチャからリモートエンドに送信されたパケットの平均ジッター。 単位: マイクロ秒 |
|
リモートエンドと Amazon Chime SDK Voice Connector インフラストラクチャ間の平均ラウンドトリップ時間。 単位: マイクロ秒 |
|
リモートエンドと Amazon Chime SDK Voice Connector インフラストラクチャ間の音声ストリームに関連する推定平均オリジンスコア (MOS)。 単位: 単位: 1.0~4.4 のスコア。スコアが高いほど、認識されるオーディオ品質が向上します。 |
Amazon Chime SDK の CloudWatch ディメンション
Amazon Chime SDK で使用できる CloudWatch ディメンションを以下に示します。
ディメンション | 説明 |
---|---|
|
メトリクスを表示する Amazon Chime SDK Voice Connector の識別子。 |
|
イベントに関連付けられた 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/${
です。以下のフィールドが JSON 形式でログに含まれます。VoiceConnectorID
}
フィールド | 説明 |
---|---|
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 メッセージ。 |