スクレイパー設定
Amazon CloudWatch マネージド Prometheus コレクターは、Prometheus 互換の YAML 設定を使用して、コレクターがメトリクスをスクレイプする方法を定義します。スクレイパーの作成時または更新時に、この設定を base64 エンコードされたブロブとして提供します。この設定は標準的な Prometheus スクレイプ設定形式を使用しますが、マネージドコレクターに特有の制限がいくつかあります。
GetDefaultScraperConfiguration を使用して、汎用スクレーパー設定を取得するか、独自のものを提供できます。
サポートされている設定セクション
Prometheus スクレイプ設定の以下のトップレベルセクションがサポートされています:
-
global–scrape_interval、scrape_timeout、external_labelsを含むグローバル設定。 -
scrape_configs– ターゲットとそれらのスクレイプ方法をそれぞれ定義するスクレイプジョブのリスト。
各 scrape_configs エントリ内で、以下のフィールドがサポートされています:
-
job_name– スクレイプジョブの一意の名前。 -
metrics_path– スクレイプ対象の HTTP パス (デフォルトは/metrics)。 -
scheme– プロトコルスキーム (httpまたはhttps)。 -
scrape_interval– グローバルなスクレイプ間隔に対するジョブごとのオーバーライド。 -
scrape_timeout– グローバルなスクレイプタイムアウトに対するジョブごとのオーバーライド。 -
static_configs– ターゲットの静的リスト。 -
dns_sd_configs– DNS ベースのサービス検出。 -
relabel_configs– スクレイプ前に適用されるリラベリングルール。 -
metric_relabel_configs– スクレイプ後に適用されるリラベリングルール。 -
tls_config– HTTPS ターゲット用の TLS 設定。
設定例
次の例は、基本的なスクレイプ設定を示しています:
global: scrape_interval: 60s scrape_timeout: 10s external_labels: environment: production scrape_configs: - job_name: 'my-service' metrics_path: /metrics scheme: http static_configs: - targets: - '10.0.1.10:9090' - '10.0.1.11:9090' labels: team: platform relabel_configs: - source_labels: [__address__] target_label: instance metric_relabel_configs: - source_labels: [__name__] regex: 'go_.*' action: drop
制限事項
-
scrape_intervalの最小値は 30 秒です。 -
マネージドコレクターはファイルベースのサービス検出 (
file_sd_configs) をサポートしていません。 -
マネージドコレクターは Consul、Eureka、その他の外部サービス検出メカニズムをサポートしていません。
-
リモート書き込みおよびリモート読み取りの設定は、CloudWatch への配信をコレクターが処理するため、適用されません。
-
設定サイズの最大値は 256 KB です。
トラブルシューティング
スクレイパーが期待どおりにメトリクスを収集しない場合は、以下を確認してください:
-
スクレイパーにアタッチされているセキュリティグループが、ターゲットポートへのアウトバウンドトラフィックを許可していることを確認します。
-
スクレイパー設定で指定したサブネットからターゲットが到達可能であることを確認します。
-
dns_sd_configsで使用される DNS 名が VPC 内で正しく解決されることを確認します。 -
ターゲットが設定された
metrics_pathで応答し、有効な Prometheus エクスポジションフォーマットを提供することを確認します。
追加のトラブルシューティングガイダンスについては、Amazon Managed Service for Prometheus ユーザーガイドの「マネージドコレクターのトラブルシューティング」を参照してください。
