

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

# Amazon CloudWatch による Amazon Chime SDK のモニタリング
<a name="monitoring-cloudwatch"></a>

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

## Amazon Chime SDK の CloudWatch メトリクス
<a name="cw-metrics"></a>

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

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

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


| メトリクス | 説明 | 
| --- | --- | 
| `SmaActiveCallCount` | アクティブな同時 Sip Media Application 呼び出しの数。<br />単位: カウント | 
| `VoiceConnectorActiveCallCount` | アクティブな同時 Voice Connector 呼び出しの数。<br />単位: カウント | 
| `InboundCallAttempts` | 試行された受信通話の数。<br />単位: 回 | 
| `InboundCallFailures` | 受信通話の失敗回数。<br />単位: 回 | 
| `InboundCallsAnswered` | 応答された受信通話の数。<br />単位: 回 | 
| `InboundCallsActive` | 現在アクティブな受信通話の数。<br />単位: カウント | 
| `OutboundCallAttempts` | 試行された発信通話の数。<br />単位: カウント | 
| `OutboundCallFailures` | 発信通話の失敗回数。<br />単位: カウント | 
| `OutboundCallsAnswered` | 応答された発信通話の数。<br />単位: カウント | 
| `OutboundCallsActive` | 現在アクティブな発信通話の数。<br />単位: カウント | 
| `Throttles` | 通話の試行時にアカウントがスロットルされる回数。<br />単位: カウント | 
| `Sip1xxCodes` | 1xx レベルのステータスコードを持つ SIP メッセージの数。<br />単位: カウント | 
| `Sip2xxCodes` | 2xx レベルのステータスコードを持つ SIP メッセージの数。<br />単位: カウント | 
| `Sip3xxCodes` | 3xx レベルのステータスコードを持つ SIP メッセージの数。<br />単位: カウント | 
| `Sip4xxCodes` | 4xx レベルのステータスコードを持つ SIP メッセージの数。<br />単位: カウント | 
| `Sip5xxCodes` | 5xx レベルのステータスコードを持つ SIP メッセージの数。<br />単位: カウント | 
| `Sip6xxCodes` | 6xx レベルのステータスコードを持つ SIP メッセージの数。<br />単位: カウント | 
| `CustomerToVcRtpPackets` | 顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信された RTP パケットの数。<br />単位: カウント | 
| `CustomerToVcRtpBytes` | RTP パケットで顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信されたバイト数。<br />単位: カウント | 
| `CustomerToVcRtcpPackets` | 顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信された RTCP パケットの数。<br />単位: カウント | 
| `CustomerToVcRtcpBytes` | RTCP パケットで顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信されたバイト数。<br />単位: カウント | 
| `CustomerToVcPacketsLost` | 顧客から Amazon Chime SDK Voice Connector インフラストラクチャへの転送中に失われたパケットの数。値は、呼び出しが終了するまで 1 分ごとに送信されます。値カウントは累積です。<br />単位: カウント | 
| `CustomerToVcJitter` | 顧客から Amazon Chime SDK Voice Connector インフラストラクチャに送信されるパケットの平均ジッター。<br />単位: マイクロ秒 | 
| `VcToCustomerRtpPackets` | Amazon Chime SDK Voice Connector インフラストラクチャからお客様に送信された RTP パケットの数。<br />単位: カウント | 
| `VcToCustomerRtpBytes` | Amazon Chime SDK Voice Connector インフラストラクチャから RTP パケットでお客様に送信されたバイト数。<br />単位: カウント | 
| `VcToCustomerRtcpPackets` | Amazon Chime SDK Voice Connector インフラストラクチャからお客様に送信された RTCP パケットの数。<br />単位: カウント | 
| `VcToCustomerRtcpBytes` | Amazon Chime SDK Voice Connector インフラストラクチャから RTCP パケットで顧客に送信されたバイト数。<br />単位: カウント | 
| `VcToCustomerPacketsLost` | Amazon Chime SDK Voice Connector インフラストラクチャからお客様への転送中に失われたパケットの数。値は、呼び出しが終了するまで 1 分ごとに送信されます。値カウントは累積です。<br />単位: カウント | 
| `VcToCustomerJitter` | Amazon Chime SDK Voice Connector インフラストラクチャからお客様に送信されるパケットの平均ジッター。<br />単位: マイクロ秒 | 
| `RTTBetweenVcAndCustomer` | 顧客と Amazon Chime SDK Voice Connector インフラストラクチャ間の平均往復時間。<br />単位: マイクロ秒 | 
| `MOSBetweenVcAndCustomer` | 顧客と Amazon Chime SDK Voice Connector インフラストラクチャ間の音声ストリームに関連する推定平均オピニオンスコア (MOS)。<br />単位: 1.0～4.4 のスコア。スコアが高いほど、認識されるオーディオ品質が向上します。 | 
| `RemoteToVcRtpPackets` | リモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャに送信された RTP パケットの数。<br />単位: カウント | 
| `RemoteToVcRtpBytes` | リモートエンドから RTP パケット内の Amazon Chime SDK Voice Connector インフラストラクチャに送信されたバイト数。<br />単位: カウント | 
| `RemoteToVcRtcpPackets` | リモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャに送信された RTCP パケットの数。<br />単位: カウント | 
| `RemoteToVcRtcpBytes` | リモートエンドから RTCP パケット内の Amazon Chime SDK Voice Connector インフラストラクチャに送信されたバイト数。<br />単位: カウント | 
| `RemoteToVcPacketsLost` | リモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャへの転送中に失われたパケットの数。値は、呼び出しが終了するまで 1 分ごとに送信されます。値カウントは累積です。<br />単位: カウント | 
| `RemoteToVcJitter` | リモートエンドから Amazon Chime SDK Voice Connector インフラストラクチャに送信されるパケットの平均ジッター。<br />単位: マイクロ秒 | 
| `VcToRemoteRtpPackets` | Amazon Chime SDK Voice Connector インフラストラクチャからリモートエンドに送信された RTP パケットの数。<br />単位: カウント | 
| `VcToRemoteRtpBytes` | Amazon Chime SDK Voice Connector インフラストラクチャから RTP パケットのリモートエンドに送信されたバイト数。<br />単位: カウント | 
| `VcToRemoteRtcpPackets` | Amazon Chime SDK Voice Connector インフラストラクチャからリモートエンドに送信された RTCP パケットの数。<br />単位: カウント | 
| `VcToRemoteRtcpBytes` | Amazon Chime SDK Voice Connector インフラストラクチャから RTCP パケットのリモートエンドに送信されたバイト数。<br />単位: カウント | 
| `VcToRemotePacketsLost` | Amazon Chime SDK Voice Connector インフラストラクチャからリモートエンドへの転送中に失われたパケットの数。値は、呼び出しが終了するまで 1 分ごとに送信されます。値カウントは累積です。<br />単位: カウント | 
| `VcToRemoteJitter` | Amazon Chime SDK Voice Connector インフラストラクチャからリモートエンドに送信されるパケットの平均ジッター。<br />単位: マイクロ秒 | 
| `RTTBetweenVcAndRemote` | リモートエンドと Amazon Chime SDK Voice Connector インフラストラクチャ間の平均往復時間。<br />単位: マイクロ秒 | 
| `MOSBetweenVcAndRemote` | リモートエンドと Amazon Chime SDK Voice Connector インフラストラクチャ間の音声ストリームに関連する推定平均オピニオンスコア (MOS)。<br />単位: 単位: 1.0～4.4 のスコア。スコアが高いほど、認識されるオーディオ品質が向上します。 | 

## Amazon Chime SDK の CloudWatch ディメンション
<a name="cw-dimensions"></a>

Amazon Chime SDK で使用できる CloudWatch ディメンションは次のとおりです。


| ディメンション | 説明 | 
| --- | --- | 
| `VoiceConnectorId` | メトリクスを表示する Amazon Chime SDK Voice Connector の識別子。 | 
| `Region` | イベントに関連付けられた AWS リージョン。 | 

## Amazon Chime SDK の CloudWatch ログ
<a name="cw-logs"></a>

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 設定の編集](edit-voicecon.md)。

**注記**  
パケット損失メトリクスは、通話中に累積されます。たとえば、パケット損失が 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 を使用したログデータの分析](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)」を参照してください。 | 
| 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 メッセージ。 | 