翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Amazon EMR 7.1.0 用 CloudWatch エージェントの設定 Amazon EMR 7.1.0 以降、Amazon EMR 設定 API を使用して、追加のシステムメトリクスを使用するように Amazon CloudWatch エージェントを設定し、アプリケーションメトリクスを追加し、メトリクスの送信先を変更することができます。EMR 設定 API を使用してクラスターのアプリケーションを設定する方法の詳細については、「[Configure applications](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-configure-apps.html)」を参照してください。 **注記** 7.1.0 は、再設定タイプ `OVERWRITE` のみをサポートします。再構成タイプの詳細については、「[インスタンスグループの再設定時の考慮事項](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-configure-apps-running-cluster.html#emr-configure-apps-running-cluster-considerations)」を参照してください。 **Topics** + [設定のスキーマ](#AmazonCloudWatchAgent-config-710-config-schema) + [システムメトリクス設定の例](#AmazonCloudWatchAgent-config-710-system-examples) + [アプリケーションメトリクス設定の例](#AmazonCloudWatchAgent-config-710-application-examples) + [Amazon Managed Service for Prometheus の例](#AmazonCloudWatchAgent-config-710-prometheus-examples) ## 設定のスキーマ `emr-metrics` には次の分類があります。 + `emr-system-metrics` — CPU、ディスク、メモリなどのシステムメトリクスを設定。 + `emr-hadoop-hdfs-datanode-metrics` — Hadoop DataNode JMX メトリクスを設定 + `emr-hadoop-hdfs-namenode-metrics` — Hadoop NameNode JMX メトリクスを設定 + `emr-hadoop-yarn-nodemanager-metrics` — Yarn NodeManager JMX メトリクスを設定 + `emr-hadoop-yarn-resourcemanager-metrics` — Yarn ResourceManager JMX メトリクスを設定 + `emr-hbase-master-metrics` — HBase Master JMX メトリクスを設定 + `emr-hbase-region-server-metrics` — HBase Region Server JMX メトリクスを設定 + `emr-hbase-rest-server-metrics` — HBase REST Server JMX メトリクスを設定 + `emr-hbase-thrift-server-metrics` — HBase Thrift Server JMX メトリクスを設定 以下の表は、すべての分類で使用できるプロパティと設定について説明しています。 **emr-metrics プロパティ** | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | 注意事項 | | --- | --- | --- | --- | --- | --- | | metrics\_destination | オプションです。 | クラスターメトリクスを Amazon CloudWatch または Amazon Managed Service for Prometheus に発行するかどうかを決定します。 | "CLOUDWATCH" | "CLOUDWATCH"、"PROMETHEUS" | このプロパティでは、大文字と小文字は区別されません。例えば、「Cloudwatch」は「CLOUDWATCH」と同じです。 | | prometheus\_endpoint | オプションです。 | metrics\_destination が「PROMETHEUS」に設定されている場合、このプロパティは CloudWatch エージェントを設定して、提供された Amazon Managed Service for Prometheus リモート書き込みエンドポイントにメトリクスを送信します。 | 該当なし | あらゆる有効な Amazon Managed Service for Prometheus リモート書き込み URL。リモート書き込み URL 形式は 
https://aps-workspaces.{{}}.amazonaws.com/workspaces/{{}}/api/v1/remote_write
| metrics\_destination が「PROMETHEUS」に設定されている場合、このフィールドは必須です。キーを指定しない場合、または値が空の文字列の場合、プロビジョニングは失敗します。 | **emr-system-metrics プロパティ** | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | 注意事項 | | --- | --- | --- | --- | --- | --- | | metrics\_collection\_interval | オプションです。 | CloudWatch エージェントからメトリクスが収集され、公開される頻度。 | "60" | 秒数を指定する文字列。整数のみを受け入れます。 | このプロパティは、個々のメトリクスグループの metrics\_collection\_interval プロパティで上書きできます。 | **emr-system-metrics 設定** ------ #### [ cpu ] | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | 注意事項 | | --- | --- | --- | --- | --- | --- | | metrics | オプションです。 | エージェントが収集する CPU メトリクスのリスト。 | 「[Default metrics for CloudWatch agent with Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-metrics.html)」を参照してください | usage\_active や cpu\_time\_idle など、cpu\_ プレフィックスの有無にかかわらず、有効な CPU メトリクス名のカンマ区切りリスト。有効なメトリクスについては、「[CloudWatch エージェントにより収集されるメトリクス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent)」を参照してください。 | 空の文字列を指定すると、CPU メトリクスは発行されません。 | | metrics\_collection\_interval | オプションです。 | エージェントが CPU メトリクスを収集して公開する秒数。 | グローバル metrics\_collection\_interval の値。 | 秒数を指定する文字列。整数のみを受け入れます。 | この値は、CPU メトリクスのグローバル metrics\_collection\_interval プロパティのみを上書きします。 | | drop\_original\_metrics | オプションです。 | 集計されていないメトリクスを発行しない CPU メトリクスのリスト。 | 集計されていない CPU メトリクスは公開されていません。 | メトリクスプロパティでも指定されている CPU メトリクスのカンマ区切りリスト。空の文字列は、すべての CPU メトリクスを発行することを意味します。 | CloudWatch エージェントは、クラスター ID、インスタンス ID、ノードタイプ、サービス名別にすべてのメトリクスを集計します。デフォルトでは、CloudWatch エージェントは複数のリソースを持つメトリクスのリソースごとのメトリクスを発行しません。 | | resources | オプションです。 | エージェントがコアごとのメトリクスを発行するかどうかを決定します。 | "\*" | 「\*」はコアごとのメトリクスを有効にします。「」はコアごとのメトリクスを無効にします。 | CloudWatch エージェントは、drop\_original\_metrics で削除されない CPU メトリクスのコアごとのメトリクスのみを公開します。 | ------ #### [ disk ] | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | 注意事項 | | --- | --- | --- | --- | --- | --- | | metrics | オプションです。 | エージェントが収集するディスクメトリクスのリスト。 | 「[Default metrics for CloudWatch agent with Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-metrics.html)」を参照してください | disk\_total や used\_percent など、disk\_ プレフィックスの有無にかかわらず、有効なディスクメトリクス名のカンマ区切りリスト。有効なメトリクスについては、「[CloudWatch エージェントにより収集されるメトリクス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent)」を参照してください。 | 空の文字列を指定すると、ディスクメトリクスは発行されません。 | | metrics\_collection\_interval | オプションです。 | エージェントがディスクメトリクスを収集して発行する秒数。 | グローバル metrics\_collection\_interval の値。 | 秒数を指定する文字列。整数のみを受け入れます。 | この値は、ディスクメトリクスのグローバル metrics\_collection\_interval プロパティのみを上書きします。 | | drop\_original\_metrics | オプションです。 | 集計されていないメトリクスを発行しないディスクメトリクスのリスト。 | 集計されていないディスクメトリクスは公開されていません。 | メトリクスプロパティでも指定されているディスクメトリクスのカンマ区切りリスト。空の文字列は、すべてのディスクメトリクスを発行することを意味します。 | CloudWatch エージェントは、クラスター ID、インスタンス ID、ノードタイプ、サービス名別にすべてのメトリクスを集計します。デフォルトでは、CloudWatch エージェントは複数のリソースを持つメトリクスのリソースごとのメトリクスを発行しません。 | | resources | オプションです。 | エージェントがマウントポイントごとのメトリクスを発行するかどうかを決定します。 | "\*" | 「\*」はすべてのマウントポイントを意味し、「」はマウントポイントなし、またはカンマ区切りのマウントポイントのリストを意味します。例えば、"/,/emr"。 | CloudWatch エージェントは、drop\_original\_metrics で削除されていないディスクメトリクスのマウントポイントごとのメトリクスのみを公開します。 | ------ #### [ diskio ] | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | 注意事項 | | --- | --- | --- | --- | --- | --- | | metrics | オプションです。 | エージェントが収集するディスク IO メトリクスのリスト。 | 「[Default metrics for CloudWatch agent with Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-metrics.html)」を参照してください | diskio\_reads や writes など、diskio\_ プレフィックスの有無にかかわらず、有効な IO メトリクス名のカンマ区切りリスト。有効なメトリクスについては、「[CloudWatch エージェントにより収集されるメトリクス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent)」を参照してください。 | 空の文字列を指定すると、ディスク IO メトリクスは発行されません。 | | metrics\_collection\_interval | オプションです。 | エージェントがディスク IO メトリクスを収集して発行する秒数。 | グローバル metrics\_collection\_interval の値。 | 秒数を指定する文字列。整数のみを受け入れます。 | この値は、IO メトリクスのグローバル metrics\_collection\_interval プロパティのみを上書きします。 | | drop\_original\_metrics | オプションです。 | 集計されていないメトリクスを発行しないディスク IO メトリクスのリスト。 | 集計されていないディスク IO メトリクスは発行されません。 | メトリクスプロパティでも指定されているディスク IO メトリクスのカンマ区切りリスト。空の文字列は、すべてのディスク IO メトリクスを発行することを意味します。 | CloudWatch エージェントは、クラスター ID、インスタンス ID、ノードタイプ、サービス名別にすべてのメトリクスを集計します。デフォルトでは、CloudWatch エージェントは複数のリソースを持つメトリクスのリソースごとのメトリクスを発行しません。 | | resources | オプションです。 | エージェントがデバイスごとのメトリクスを発行するかどうかを決定します。 | "\*" | 「\*」はすべてのストレージデバイスを意味し、「」は 0 のストレージデバイス、またはデバイス名のカンマ区切りリストを意味します。例えば、"nvme0n1,nvme1n1"。 | CloudWatch エージェントは、drop\_original\_metrics で削除されていないディスク IO メトリクスのデバイスごとのメトリクスのみを公開します。 | ------ #### [ mem ] | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | 注意事項 | | --- | --- | --- | --- | --- | --- | | metrics | オプションです。 | エージェントが収集するメモリメトリクスのリスト。 | 「[Default metrics for CloudWatch agent with Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-metrics.html)」を参照してください | mem\_available や available\_percent など、mem\_ プレフィックスの有無にかかわらず、有効なメモリメトリクス名のカンマ区切りリスト。有効なメトリクスについては、「[CloudWatch エージェントにより収集されるメトリクス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent)」を参照してください。 | 空の文字列を指定すると、メモリメトリクスは発行されません。 | | metrics\_collection\_interval | オプションです。 | エージェントがメモリメトリクスを収集して発行する秒数。 | グローバル metrics\_collection\_interval の値。 | 秒数を指定する文字列。整数のみを受け入れます。 | この値は、メモリメトリクスに対してのみグローバル metrics\_collection\_interval プロパティを上書きします。 | ------ #### [ net ] | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | 注意事項 | | --- | --- | --- | --- | --- | --- | | metrics | オプションです。 | エージェントが収集するネットワークメトリクスのリスト。 | 「[Default metrics for CloudWatch agent with Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-metrics.html)」を参照してください | net\_packets\_sent や packets\_recv など、net\_ プレフィックスの有無にかかわらず、有効なネットワークメトリクス名のカンマ区切りリスト。有効なメトリクスについては、「[CloudWatch エージェントにより収集されるメトリクス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent)」を参照してください。 | 空の文字列を指定すると、ネットワークメトリクスは発行されません。 | | metrics\_collection\_interval | オプションです。 | エージェントがネットワークメトリクスを収集して公開する秒数。 | グローバル metrics\_collection\_interval の値。 | 秒数を指定する文字列。整数のみを受け入れます。 | この値は、ネットワークメトリクスに対してのみグローバル metrics\_collection\_interval プロパティを上書きします。 | | drop\_original\_metrics | オプションです。 | 集計されていないメトリクスを発行しないネットワークメトリクスのリスト。 | 集計されていないネットワークメトリクスは公開されていません。 | メトリクスプロパティでも指定されているネットワークメトリクスのカンマ区切りリスト。空の文字列は、すべてのネットワークメトリクスを発行することを意味します。 | CloudWatch エージェントは、クラスター ID、インスタンス ID、ノードタイプ、サービス名別にすべてのメトリクスを集計します。デフォルトでは、CloudWatch エージェントは複数のリソースを持つメトリクスのリソースごとのメトリクスを発行しません。 | | resources | オプションです。 | エージェントがインターフェイスごとのメトリクスを発行するかどうかを決定します。 | "\*" | 「\*」とは、すべてのネットワークインターフェイスを意味し、「」は 0 のネットワークインターフェイス、またはインターフェイス名のカンマ区切りリストを意味します。例えば、"eth0,eth1"。 | CloudWatch エージェントは、drop\_original\_metrics で削除されていないネットワークメトリクスのインターフェイスごとのメトリクスのみを公開します。 | ------ #### [ netstat ] | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | 注意事項 | | --- | --- | --- | --- | --- | --- | | metrics | オプションです。 | エージェントが収集するネットワーク統計メトリクスのリスト。 | 「[Default metrics for CloudWatch agent with Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-metrics.html)」を参照してください | tcp\_listen や netstat\_udp\_socket など、netstat\_ プレフィックスの有無にかかわらず、有効なメモリメトリクス名のカンマ区切りリスト。有効なメトリクスについては、「[CloudWatch エージェントにより収集されるメトリクス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent)」を参照してください。 | 空の文字列を指定すると、ネットワーク統計メトリクスは発行されません。 | | metrics\_collection\_interval | オプションです。 | エージェントがネットワーク統計メトリクスを収集して公開する秒数。 | グローバル metrics\_collection\_interval の値。 | 秒数を指定する文字列。整数のみを受け入れます。 | この値は、ネットワーク統計メトリクスに対してのみグローバル metrics\_collection\_interval プロパティを上書きします。 | ------ #### [ processes ] | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | 注意事項 | | --- | --- | --- | --- | --- | --- | | metrics | オプションです。 | エージェントが収集するプロセスメトリクスのリスト。 | 「[Default metrics for CloudWatch agent with Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-metrics.html)」を参照してください | processes\_running や total など、processes\_ プレフィックスの有無にかかわらず、有効なメモリメトリクス名のカンマ区切りリスト。有効なメトリクスについては、「[CloudWatch エージェントにより収集されるメトリクス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent)」を参照してください。 | 空の文字列を指定すると、プロセスメトリクスは発行されません。 | | metrics\_collection\_interval | オプションです。 | エージェントがシステムプロセスメトリクスを収集して公開する秒数。 | グローバル metrics\_collection\_interval の値。 | 秒数を指定する文字列。整数のみを受け入れます。 | この値は、システムプロセスメトリクスに対してのみグローバル metrics\_collection\_interval プロパティを上書きします。 | ------ #### [ swap ] | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | 注意事項 | | --- | --- | --- | --- | --- | --- | | metrics | オプションです。 | エージェントが収集するスワップメトリクスのリスト。 | 「[Default metrics for CloudWatch agent with Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-metrics.html)」を参照してください | swap\_free や used\_percent など、swap\_ プレフィックスの有無にかかわらず、有効なメモリメトリクス名のカンマ区切りリスト。有効なメトリクスについては、「[CloudWatch エージェントにより収集されるメトリクス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent)」を参照してください。 | 空の文字列を指定すると、スワップメトリクスは発行されません。 | | metrics\_collection\_interval | オプションです。 | エージェントがスワップメトリクスを収集して発行する秒数。 | グローバル metrics\_collection\_interval の値。 | 秒数を指定する文字列。整数のみを受け入れます。 | この値は、スワップメトリクスに対してのみグローバル metrics\_collection\_interval プロパティをオーバーライドします。 | ------ **emr-hadoop-hdfs-datanode-metrics プロパティ** | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | | --- | --- | --- | --- | --- | | {{}} | オプションです。 | 該当なし | Hadoop:service=DataNode,name=DataNodeActivity など、CloudWatch エージェントがメトリクスを収集する MBean。Amazon EMR リリース 7.0 の [JMX YAML ファイルのサンプル](https://github.com/aws-samples/aws-emr-utilities/tree/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings)には、MBean 名とその対応するメトリクスのサンプルがあります。 | MBean に関連付けられているメトリクスのカンマ区切りリストを含む文字列。例えば、BlocksCached,BlocksRead。 | | otel.metric.export.interval | オプションです。 | Hadoop DataNode メトリクスを収集するミリ秒単位の頻度。 | "60000" | ミリ秒数を指定する文字列。整数のみを受け入れます。 | **emr-hadoop-hdfs-namenode-metrics プロパティ** | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | | --- | --- | --- | --- | --- | | {{}} | オプションです。 | 該当なし | Hadoop:service=NameNode,name=FSNamesystem など、CloudWatch エージェントがメトリクスを収集する MBean。Amazon EMR リリース 7.0 の [JMX YAML ファイルのサンプル](https://github.com/aws-samples/aws-emr-utilities/tree/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings)には、MBean 名とその対応するメトリクスのサンプルがあります。 | MBean に関連付けられているメトリクスのカンマ区切りリストを含む文字列。例えば、BlockCapacity,CapacityUsedGB。 | | otel.metric.export.interval | オプションです。 | Hadoop NameNode メトリクスを収集するミリ秒単位の頻度。 | "60000" | ミリ秒数を指定する文字列。整数のみを受け入れます。 | **emr-hadoop-yarn-nodemanager-metrics プロパティ** | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | | --- | --- | --- | --- | --- | | {{}} | オプションです。 | 該当なし | Hadoop:service=NodeManager,name=NodeManagerMetrics など、CloudWatch エージェントがメトリクスを収集する MBean。Amazon EMR リリース 7.0 の [JMX YAML ファイルのサンプル](https://github.com/aws-samples/aws-emr-utilities/tree/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings)には、MBean 名とその対応するメトリクスのサンプルがあります。 | MBean に関連付けられているメトリクスのカンマ区切りリストを含む文字列。例えば、MaxCapacity,AllocatedGB。 | | otel.metric.export.interval | オプションです。 | Hadoop YARN NodeManager メトリクスを収集するミリ秒単位の頻度。 | "60000" | ミリ秒数を指定する文字列。整数のみを受け入れます。 | **emr-hadoop-yarn-resourcemanager-metrics プロパティ** | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | | --- | --- | --- | --- | --- | | {{}} | オプションです。 | 該当なし | Hadoop:service=ResourceManager,name=PartitionQueueMetrics など、CloudWatch エージェントがメトリクスを収集する MBean。Amazon EMR リリース 7.0 の [JMX YAML ファイルのサンプル](https://github.com/aws-samples/aws-emr-utilities/tree/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings)には、MBean 名とその対応するメトリクスのサンプルがあります。 | MBean に関連付けられているメトリクスのカンマ区切りリストを含む文字列。例えば、MaxCapacity,MaxCapacityVCores。 | | otel.metric.export.interval | オプションです。 | Hadoop YARN ResourceManager メトリクスを収集するミリ秒単位の頻度。 | "60000" | ミリ秒数を指定する文字列。整数のみを受け入れます。 | **emr-hbase-master-metrics プロパティ** | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | | --- | --- | --- | --- | --- | | {{}} | オプションです。 | 該当なし | Hadoop:service=HBase,name=Master,sub=AssignmentManager など、CloudWatch エージェントがメトリクスを収集する MBean。Amazon EMR リリース 7.0 の [JMX YAML ファイルのサンプル](https://github.com/aws-samples/aws-emr-utilities/tree/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings)には、MBean 名とその対応するメトリクスのサンプルがあります。 | MBean に関連付けられているメトリクスのカンマ区切りリストを含む文字列。例えば、AssignFailedCount,AssignSubmittedCount。 | | otel.metric.export.interval | オプションです。 | HBase Master メトリクスを収集するミリ秒単位の頻度。 | "60000" | ミリ秒数を指定する文字列。整数のみを受け入れます。 | **emr-hbase-region-server-metrics プロパティ** | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | | --- | --- | --- | --- | --- | | {{}} | オプションです。 | 該当なし | Hadoop:service=HBase,name=RegionServer,sub=IPC など、CloudWatch エージェントがメトリクスを収集する MBean。Amazon EMR リリース 7.0 の [JMX YAML ファイルのサンプル](https://github.com/aws-samples/aws-emr-utilities/tree/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings)には、MBean 名とその対応するメトリクスのサンプルがあります。 | MBean に関連付けられているメトリクスのカンマ区切りリストを含む文字列。例えば、numActiveHandler,numActivePriorityHandler。 | | otel.metric.export.interval | オプションです。 | HBase Region Server メトリクスを収集するミリ秒単位の頻度。 | "60000" | ミリ秒数を指定する文字列。整数のみを受け入れます。 | **emr-hbase-rest-server-metrics プロパティ** | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | | --- | --- | --- | --- | --- | | {{}} | オプションです。 | 該当なし | Hadoop:service=HBase,name=REST など、CloudWatch エージェントがメトリクスを収集する MBean。Amazon EMR リリース 7.0 の [JMX YAML ファイルのサンプル](https://github.com/aws-samples/aws-emr-utilities/tree/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings)には、MBean 名とその対応するメトリクスのサンプルがあります。 | MBean に関連付けられているメトリクスのカンマ区切りリストを含む文字列。例えば、successfulPut,successfulScanCount。 | | otel.metric.export.interval | オプションです。 | HBase Rest Server メトリクスを収集するミリ秒単位の頻度。 | "60000" | ミリ秒数を指定する文字列。整数のみを受け入れます。 | **emr-hbase-thrift-server-metrics プロパティ** | プロパティ | 必要 | 説明 | デフォルトの値 | 使用できる値 | | --- | --- | --- | --- | --- | | {{}} | オプションです。 | 該当なし | Hadoop:service=HBase,name=Thrift,sub=ThriftOne など、CloudWatch エージェントがメトリクスを収集する MBean。Amazon EMR リリース 7.0 の [JMX YAML ファイルのサンプル](https://github.com/aws-samples/aws-emr-utilities/tree/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings)には、MBean 名とその対応するメトリクスのサンプルがあります。 | MBean に関連付けられているメトリクスのカンマ区切りリストを含む文字列。例えば、BatchGet\_max,BatchGet\_mean。 | | otel.metric.export.interval | オプションです。 | HBase Thrift サーバーメトリクスを収集するミリ秒単位の頻度。 | "60000" | ミリ秒数を指定する文字列。整数のみを受け入れます。 | ## システムメトリクス設定の例 次の例は、すべてのシステムメトリクスのエクスポートを停止するように CloudWatch エージェントを設定する方法を示しています。 ``` [ { "Classification": "emr-metrics", "Properties": {}, "Configurations": [ { "Classification": "emr-system-metrics", "Properties": {}, "Configurations": [] } ] } ] ``` 次の例では、デフォルトのシステムメトリクスをエクスポートするように CloudWatch エージェントを設定します。これを行うと、システムメトリクスを少なくとも 1 回再設定した場合、エージェントをデフォルトのシステムメトリクスのエクスポートのみにリセットできます。このリセットにより、以前に再設定されたアプリケーションメトリクスも削除されます。 ``` [ { "Classification": "emr-metrics", "Properties": {}, "Configurations": [] } ] ``` 次の例では、`cpu`、`mem`、`disk` メトリクスをエクスポートするようにクラスターを設定します。 ``` [ { "Classification": "emr-metrics", "Properties": {}, "Configurations": [ { "Classification": "emr-system-metrics", "Properties": { "metrics_collection_interval": "20" }, "Configurations": [ { "Classification": "cpu", "Properties": { "metrics": "cpu_usage_guest,cpu_usage_idle", "metrics_collection_interval": "30", "drop_original_metrics": "cpu_usage_guest" } }, { "Classification": "mem", "Properties": { "metrics": "mem_active" } }, { "Classification": "disk", "Properties": { "metrics": "disk_used_percent", "resources": "/,/mnt", "drop_original_metrics": "" } } ] } ] } ] ``` 前の例の設定は以下のようなプロパティを持ちます。 + 30 秒ごとに、エージェントはすべての CPU の `cpu_guest` メトリクスを収集します。集計メトリクスは CloudWatch 名前空間 `CWAgent > cluster.id, instance.id, node.type, service.name` にあります。 + 30 秒ごとに、エージェントはすべての CPU の `cpu_idle` メトリクスを収集します。集計メトリクスは CloudWatch 名前空間 `CWAgent > cluster.id, instance.id, node.type, service.name` にあります。エージェントは、CPU ごとのメトリクスも収集します。同じ名前空間で見つけることができます。`drop_original_metrics` プロパティに `cpu_idle` が含まれていないため、エージェントはメトリクスを無視しないため、このメトリクスを収集します。 + 20 秒ごとに、エージェントは `mem_active` メトリクスを収集します。集計メトリクスは CloudWatch 名前空間 `CWAgent > cluster.id, instance.id, node.type, service.name` にあります。 + 20 秒ごとに、エージェントは `/` と `/mnt` ディスクマウントの `disk_used_percent` メトリクスを収集します。集計されたメトリクスは CloudWatch 名前空間 `CWAgent > cluster.id, instance.id, node.type, service.name` にあります。エージェントは、マウントごとのメトリクスも収集します。同じ名前空間で見つけることができます。`drop_original_metrics` プロパティに `disk_used_percent` が含まれていないため、エージェントはメトリクスを無視しないため、このメトリクスを収集します。 ## アプリケーションメトリクス設定の例 次の例では、Hadoop Namenode サービスのメトリクスのエクスポートを停止するように CloudWatch エージェントを設定します。 ``` [ { "Classification": "emr-metrics", "Properties": {}, "Configurations": [ { "Classification": "emr-hadoop-hdfs-namenode-metrics", "Properties": {}, "Configurations": [] } ] } ] ``` 次の例では、Hadoop アプリケーションメトリクスをエクスポートするようにクラスターを設定します。 ``` [ { "Classification": "emr-metrics", "Properties": {}, "Configurations": [ { "Classification": "emr-hadoop-hdfs-namenode-metrics", "Properties": { "Hadoop:service=NameNode,name=FSNamesystem": "BlockCapacity,CapacityUsedGB", "otel.metric.export.interval": "20000" }, "Configurations": [] }, { "Classification": "emr-hadoop-hdfs-datanode-metrics", "Properties": { "Hadoop:service=DataNode,name=JvmMetrics": "MemNonHeapUsedM", "otel.metric.export.interval": "30000" }, "Configurations": [] }, { "Classification": "emr-hadoop-yarn-resourcemanager-metrics", "Properties": { "Hadoop:service=ResourceManager,name=CapacitySchedulerMetrics": "AllocateNumOps,NodeUpdateNumOps" }, "Configurations": [] } ] } ] ``` 前の例には、次のプロパティがあります。 + 20 秒ごとに、エージェントは Hadoop Namenode サービスを実行しているインスタンスから `BlockCapacity` および `CapacityUsedGB` メトリクスを収集します。 + 30 秒ごとに、エージェントは Hadoop Datanode サービスを実行しているインスタンスから `MemNonHeapUsedM` メトリクスを収集します。 + 30 秒ごとに、エージェントは Hadoop YARN ResourceManaager を実行するインスタンスから `AllocateNumOps` および `NodeUpdateNumOps` メトリクスを収集します。 ## Amazon Managed Service for Prometheus の例 次の例は、メトリクスを Amazon Managed Service for Prometheus にエクスポートするように CloudWatch エージェントを設定する方法を示しています。 現在、メトリクスを Amazon Managed Service for Prometheus にエクスポートしていて、クラスターのメトリクスを再設定し、メトリクスを Amazon Managed Service for Prometheus にエクスポートし続ける場合は、プロパティ `metrics_destination` と `prometheus_endpoint` を含める必要があります。 ``` [ { "Classification": "emr-metrics", "Properties": { "metrics_destination": "prometheus", "prometheus_endpoint": "http://amp-workspace/api/v1/remote_write" }, "Configurations": [] } ] ``` CloudWatch エージェントを使用してメトリクスを CloudWatch にエクスポートするには、次の例を使用します。 ``` [ { "Classification": "emr-metrics", "Properties": { "metrics_destination": "cloudwatch" }, "Configurations": [] } ] ``` **注記** CloudWatch エージェントには、特定の属性の名前を変更する Prometheus エクスポーターがあります。デフォルトのメトリクスラベルでは、Amazon Managed Service for Prometheus は Amazon CloudWatch が使用するピリオドの代わりにアンダースコア文字を使用します。Amazon Managed Grafana を使用して Amazon Managed Service for Prometheus のデフォルトメトリクスを視覚化すると、ラベルは `cluster_id`、`instance_id`、`node_type`、`service_name` のように表示されます。