翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# CloudWatch メトリクスによるモニタリング
このセクションの表を使用して、Amazon CloudWatch Logs が毎分 Amazon CloudWatch に送信するメトリクスを確認できます。
## CloudWatch Logs のメトリック
`AWS/Logs` 名前空間には、次のメトリクスが含まれます。
| メトリクス | 説明 |
| --- | --- |
| `CallCount` | アカウントで実行された指定された API オペレーションの数。 `CallCount` は CloudWatch Logs サービスの使用状況メトリクスです。詳細については、「[CloudWatch Logs サービスの使用状況メトリクス](#CloudWatchLogs-Usage-Metrics)」を参照してください。 有効なディメンション: クラス、リソース、サービス、タイプ 有効な統計: Sum 単位: なし |
| `DeliveryErrors` | データをサブスクリプション送信先に転送するときに CloudWatch Logs がエラーを受け取ったログイベントの数。送信先のサービスが、スロットリングの例外や再試行可能なサービス例外 (HTTP 5xx など) の再試行可能なエラーを返した場合、CloudWatch Logs は最大 24 時間配信を再試行し続けます。`AccessDeniedException` や `ResourceNotFoundException` などの再試行不可能なエラーの場合、CloudWatch Logs は再配信を試みません。 有効なディメンション: LogGroupName、DestinationType、FilterName、PolicyLevel 有効な統計: Sum 単位: なし |
| `DeliveryThrottling` | データをサブスクリプション送信先に転送するときに CloudWatch Logs がスロットルされたログイベントの数。 送信先のサービスが、スロットリングの例外や再試行可能なサービス例外 (HTTP 5xx など) の再試行可能なエラーを返した場合、CloudWatch Logs は最大 24 時間配信を再試行し続けます。`AccessDeniedException` や `ResourceNotFoundException` などの再試行不可能なエラーの場合、CloudWatch Logs は再配信を試みません。 有効なディメンション: LogGroupName、DestinationType、FilterName、PolicyLevel 有効な統計: Sum 単位: なし |
| `EMFDisabledErrors` | ロググループに一致する METRIC\$1EXTRACTION\$1POLICY タイプのアクティブなアカウントポリシーが原因で無視された EMF 形式のログイベントの数。メトリクス抽出ポリシーについて詳しくは「[PutAccountPolicy](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutAccountPolicy.html)」を参照してください。 有効なディメンション: `LogGroupName` 有効な統計: Sum 単位: なし |
| `EMFParsingErrors` | 埋め込みメトリクスフォーマットログの処理中に発生した解析エラーの数。このようなエラーは、埋め込みメトリクス形式として識別されたログが、適切な形式に従っていない場合に発生します。埋め込みメトリクス形式の詳細については、「[仕様: 埋め込みメトリクスフォーマット](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format_Specification.html)」を参照してください。 有効なディメンション: `LogGroupName` 有効な統計: Sum 単位: なし |
| `EMFValidationErrors` | 埋め込みメトリクス形式ログの処理中に発生した検証エラーの数。これらのエラーは、埋め込みメトリクス形式ログ内のメトリクスの定義が、 埋め込みメトリクス形式と `MetricDatum` の仕様に準拠していない場合に発生します。埋め込みメトリクス形式の詳細については、「[仕様: 埋め込みメトリクス形式](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format_Specification.html)」を参照してください。データタイプ `MetricDatum` の詳細については、「*Amazon CloudWatch API リファレンス*」の「[MetricDatum](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html)」を参照してください。 特定の検証エラーにより、EMF ログ内の複数のメトリクスが公開されないことがあります。例えば、無効な名前空間で設定されたメトリクスはすべて削除されます。 有効なディメンション: `LogGroupName` 有効な統計: Sum 単位: なし |
| `ErrorCount` | アカウントで実行され、エラーが発生した API オペレーションの数。 `ErrorCount` は CloudWatch Logs サービスの使用状況メトリクスです。詳細については、「[CloudWatch Logs サービスの使用状況メトリクス](#CloudWatchLogs-Usage-Metrics)」を参照してください。 有効なディメンション: クラス、リソース、サービス、タイプ 有効な統計: Sum 単位: なし |
| `ForwardedBytes` | サブスクリプション送信先に転送されたログイベントのボリューム (圧縮済みバイト数)。 有効なディメンション: LogGroupName、DestinationType、FilterName 有効な統計: Sum 単位: バイト |
| `ForwardedLogEvents` | サブスクリプション送信先に転送されたログイベントの数。 有効なディメンション: LogGroupName、DestinationType、FilterName、PolicyLevel 有効な統計: Sum 単位: なし |
| `IncomingBytes` | CloudWatch Logs にアップロードされたログイベントのボリューム (非圧縮バイト数)。`LogGroupName` ディメンションと同時に使用すると、ロググループにアップロードされたログイベントのボリューム (非圧縮バイト数) になります。 有効なディメンション: LogGroupName 有効な統計: Sum 単位: バイト |
| `IncomingLogEvents` | CloudWatch Logs にアップロードされたログイベントの数。`LogGroupName` ディメンションと同時に使用すると、ロググループにアップロードされたログイベントの数になります。 有効なディメンション: LogGroupName 有効な統計: Sum 単位: なし |
| `LogEventsWithFindings` | CloudWatch Logs データ保護機能を使用して監査しているデータ文字列に一致したログイベントの数。詳細については、「[機密性の高いログデータをマスキングで保護する](mask-sensitive-log-data.md)」を参照してください。 有効なディメンション: なし 有効な統計: Sum 単位: なし |
| `ThrottleCount` | アカウントで実行され、使用クォータによって調整された API オペレーションの数。 `ThrottleCount` は CloudWatch Logs サービスの使用状況メトリクスです。詳細については、「[CloudWatch Logs サービスの使用状況メトリクス](#CloudWatchLogs-Usage-Metrics)」を参照してください。 有効なディメンション: クラス、リソース、サービス、タイプ 有効な統計: Sum 単位: なし |
## CloudWatch Logs メトリックのディメンション
ほとんどの CloudWatch Logs メトリクスで使用できるディメンションを以下のテーブルに示します。
| ディメンション | 説明 |
| --- | --- |
| LogGroupName | メトリクスを表示する CloudWatch Logs ロググループの名前。 |
| DestinationType | CloudWatch Logs データのサブスクリプション先であり、 AWS Lambda、Amazon Kinesis Data Streams、または Amazon Data Firehose を使用できます。 |
| FilterName | ロググループから送信先にデータを転送するサブスクリプションフィルタの名前。サブスクリプションフィルタ名は CloudWatch で自動的に ASCII に変換され、サポートされていない文字は疑問符 (?) に置き換えられます。 |
**サブスクリプションフィルターメトリクスのディメンション**
アカウントレベルのサブスクリプションフィルターに関連するメトリクスのディメンションを次の表に示します。
| ディメンション | 説明 |
| --- | --- |
| PolicyLevel | ポリシーが適用されるレベル。現在、このディメンションの有効な値は `AccountPolicy` のみです。 |
| DestinationType | CloudWatch Logs データのサブスクリプション先であり、 AWS Lambda、Amazon Kinesis Data Streams、または Amazon Data Firehose を使用できます。 |
| FilterName | ロググループから送信先にデータを転送するサブスクリプションフィルタの名前。サブスクリプションフィルタ名は CloudWatch で自動的に ASCII に変換され、サポートされていない文字は疑問符 (?) に置き換えられます。 |
## トランスフォーマーのメトリクスとディメンションをログに記録する
CloudWatch Logs は、以下のログトランスフォーマーメトリクスを `AWS/Logs` 名前空間の CloudWatch に発行します。
| メトリクス | 説明 |
| --- | --- |
| TransformationErrors | ログイベントの変換中に指定されたトランスフォーマーで発生したエラーの数。 単位: なし 有効な統計: Sum |
| TransformedBytes | 変換されたログイベントの出力の、非圧縮バイト単位のボリューム。 単位: バイト 有効な統計: Sum |
| TransformedLogEvents | 変換されたログイベントの数。 単位: なし 有効な統計: Sum |
以下のディメンションはトランスフォーマーメトリクスで使用されます。
| ディメンション | 説明 |
| --- | --- |
| LogGroupname | このディメンションは log-group-level トランスフォーマーにのみ使用されます。 |
| PolicyLevel | このディメンションは account-level トランスフォーマーにのみ使用されます。現在、このディメンションの有効な値は `AccountPolicy` のみです。 |
## 一元化メトリクスとディメンション
複数のアカウントとリージョンを一元的に監視する場合、CloudWatch Logs Centralization を使用するとログデータとメトリクスを一元的に統合できます。詳細については、「[クロスアカウントクロスリージョンログの一元化](CloudWatchLogs_Centralization.md)」を参照してください。
CloudWatch Logs は、以下の一元化メトリクスを `AWS/Logs`名前空間の CloudWatch に発行します。これらのメトリクスは、CloudWatch Logs 一元化ルールを使用するときに、ソースアカウントから送信先アカウントへのログデータのレプリケーションをモニタリングするのに役立ちます。
**注記**
CloudWatch は、一元化ルールの作成直後に、一元化メトリクスのレポートを開始します。メトリクスはベストエフォートベースで公開され、一元化ルールの作成後に届く新しいログイベントのみを追跡します。
| メトリクス | 説明 | で発行 |
| --- | --- | --- |
| IncomingCopiedBytes | 送信先アカウントにレプリケートされた非圧縮バイト単位のログデータの量。このメトリクスは、一元化ルールの作成後に到着する新しいログイベントにのみ適用されます。 有効なディメンション: SourceRegion、SourceAccount 有効な統計: Sum 単位: バイト | 送信先アカウント |
| IncomingCopiedLogEvents | 送信先アカウントにレプリケートされたログイベントの数。このメトリクスは、一元化ルールの作成後に到着する新しいログイベントにのみ適用されます。 有効なディメンション: SourceRegion、SourceAccount 有効な統計: Sum 単位: なし | 送信先アカウント |
| OutgoingCopiedBytes | ソースアカウントから送信先アカウントに送信された非圧縮バイト単位のログデータの量。このメトリクスは、一元化ルールの作成後に送信先にコピーされた新しいログイベントにのみ適用されます。 有効なディメンション: DestinationRegion 有効な統計: Sum 単位: バイト | ソースアカウント |
| OutgoingCopiedLogEvents | ソースアカウントから送信先アカウントに送信されたログイベントの数。このメトリクスは、一元化ルールの作成後に送信先にコピーされた新しいログイベントにのみ適用されます。 有効なディメンション: DestinationRegion 有効な統計: Sum 単位: なし | ソースアカウント |
| CentralizationError | ログデータのレプリケーション中に発生したエラーの数。エラーは、KMS キーのアクセス許可の問題、ロググループのクォータ制限、ログ階層の不一致など、さまざまな理由で発生する可能性があります。レプリケーションに失敗した特定のロググループまたはログストリームとその失敗理由を特定するには、 `ErrorType`ディメンションをモニタリングします。 有効なディメンション: ErrorType 有効な統計: Sum 単位: なし | 送信先アカウント |
| CentralizationThrottled | 一元化処理がスロットリングされた回数。スロットリングにより、一元化の処理が遅くなりますが、ログデータのレプリケートは妨げられません。 有効なディメンション: DestinationRegion 有効な統計: Sum 単位: なし | ソースアカウント |
次のディメンションは、一元化メトリクスで使用されます。
| ディメンション | 説明 |
| --- | --- |
| SourceRegion | ソースログデータが発信された AWS リージョン。 |
| SourceAccount | ソースログデータが発信された AWS アカウント ID。 |
| DestinationRegion | ログデータがレプリケートされる AWS リージョン。 |
| ErrorType | 一元化中に発生したエラーのタイプ。可能な値は以下のとおりです: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Monitoring-CloudWatch-Metrics.html) |
## CloudWatch Logs サービスの使用状況メトリクス
CloudWatch Logs は、CloudWatch Logs API オペレーションの使用状況を追跡するメトリクスを CloudWatch に送信します。これらのメトリクスは、 AWS サービスクォータに対応しています。これらのメトリクスを追跡することで、クォータを積極的に管理できます。詳細については、「[Service Quotas の統合と使用状況メトリクス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Service-Quota-Integration.html)」を参照してください。
例えば、`ThrottleCount` メトリクスを追跡したり、そのメトリクスにアラームを設定したりできます。このメトリクスの値が上昇した場合は、スロットリングされた API オペレーションのためにクォータの引き上げをリクエストすることを検討してください。CloudWatch Logs のサービスクォータの詳細については、「[CloudWatch Logs クォータ](cloudwatch_limits_cwl.md)」を参照してください。
CloudWatch Logs は、`AWS/Usage` と `AWS/Logs` の名前空間の両方で 1 分ごとにサービスクォータ使用状況メトリクスを発行します。
次の表は、CloudWatch Logs によって発行されるサービス使用状況メトリクスを示しています。これらのメトリクスには、指定された単位がありません。これらのメトリクスの最も有用な統計は `SUM` です。これは、1 分間の合計オペレーション数を表します。
これらのメトリクスは、`Service`、`Class`、`Type`、`Resource` のすべてのディメンションの値とともに発行されます。また、`Account Metrics` と呼ばれる 1 つのディメンションで発行されます。アカウント内のすべての API オペレーションのメトリクスの合計を確認するには、`Account Metrics` ディメンションを使用します。特定の API のメトリクスを検索するには、他のディメンションを使用し、`Resource` ディメンションの API オペレーションの名前を指定します。
**メトリクス**
| メトリクス | 説明 |
| --- | --- |
| `CallCount` | アカウントで実行された指定されたオペレーションの数。 `CallCount` は、`AWS/Usage` と `AWS/Logs` の両方の名前空間で発行されます。 |
| `ErrorCount` | アカウントで実行され、エラーが発生した API オペレーションの数。 `ErrorCount` は `AWS/Logs` にのみ発行されます。 |
| `ThrottleCount` | アカウントで実行され、使用クォータによって調整された API オペレーションの数。 `ThrottleCount` は `AWS/Logs` にのみ発行されます。 |
**ディメンション**
| ディメンション | 説明 |
| --- | --- |
| `Account metrics` | このディメンションを使用して、すべての CloudWatch Logs API のメトリクスの合計を取得します。 特定の API のメトリクスを表示するには、この表に示されている他のディメンションを使用して、API 名を `Resource` の値として指定します。 |
| `Service` | リソースを含む AWS サービスの名前。CloudWatch Logs 使用状況メトリクスの場合、このディメンションの値は `Logs` です。 |
| `Class` | 追跡されているリソースのクラス。CloudWatch Logs API 使用状況メトリクスでは、値が `None` のこのディメンションを使用します。 |
| `Type` | 追跡されるリソースのタイプ。現在、`Service` ディメンションが `Logs` である場合、`Type` の有効な値は `API` のみです。 |
| `Resource` | API オペレーションの名前。有効な値には、[[アクション](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_Operations.html)] にリストされているすべての API オペレーション名が含まれます。例えば、 `PutLogEvents` |