カスタム収集機能を使用すると、コンテナまたは ECS インスタンス内の特定のエンドポイントからメトリックをスクレイプできるため、Prometheus がより柔軟で自動化され、管理しやすくなります。このドキュメントでは、コンテナ環境を例として説明します。
制限事項
コンテナ環境と ECS 環境のみをサポートしています。
課金
カスタム収集には料金が発生します。詳細については、「Prometheus インスタンスの課金」をご参照ください。
前提条件
-
コンテナまたは ECS インスタンスが必要です。手順については、「ACK マネージドクラスターの作成」および「インスタンスの作成」をご参照ください。
-
コンテナクラスターまたは ECS インスタンス上のターゲットエンドポイントがメトリックを公開している必要があります。
アクセス
にログインします。 Prometheusコンソールのマネージドサービス。
-
左側のナビゲーションペインで、アクセス管理 をクリックします。
-
アクセス済みの環境 タブの コンテナ環境 リストで、対象のコンテナ環境の アクション 列にある メトリックの収集 をクリックして メトリックの収集 ページを開きます。
-
メトリックの収集 タブで、カスタム収集 をクリックします。
カスタム収集リスト
カスタム収集 ページには、現在のコンテナまたは ECS 環境のすべてのカスタム収集設定が一覧表示されます。
リストには、[名前]、[ジョブ名]、[コンポーネント]、[サービスディスカバリ方式]、[スクレイプパス]、[スクレイプ間隔]、および [操作] の列が含まれます。[操作] 列では、タスクの [無効化]、[設定の編集]、および [削除] を実行できます。ページの右上隅にある [作成] ボタンをクリックして収集タスクを追加し、[ジョブ名] でタスクを検索できます。
カスタム収集の作成
カスタム収集 ページで、新規追加 をクリックします。カスタム収集タスクの追加 パネルで、Job Name を入力し、カスタム収集 YAML 設定をコードエディタに貼り付け、チェックして作成する をクリックします。
YAML 設定は、Prometheus の scrape_configs 形式を使用します。job1 や job2 など、複数のジョブを定義できます。各ジョブには、honor_timestamps、honor_labels、scrape_interval (例: 30s)、scheme (例: http)、metrics_path (例: /metric)、および static_configs 配下の targets (例: 127.0.0.1:9090) などのフィールドを含めることができます。
スクレイプ間隔と Grafana クエリステップ
YAML 設定の scrape_interval (または ServiceMonitor/PodMonitor の interval) は、Prometheus がターゲットエンドポイントをスクレイプする頻度を制御します。たとえば、interval: 5s は、Prometheus が 5 秒ごとにメトリックをスクレイプすることを意味します。
クエリステップは、Grafana パネルに表示されるデータ粒度を決定します。これはスクレイプ間隔とは独立しています。Grafana は、max(Min interval, Time range / Max data points) という式を使用して実際のクエリステップを計算します。スクレイプ間隔が 5 秒であっても、長い時間範囲を表示する場合、Grafana は 15 秒または 30 秒の粒度でデータを表示する場合があります。
Grafana のデータ粒度をスクレイプ間隔に一致させるには、パネルエディターで [クエリオプション] を展開します。[最小間隔] をスクレイプ間隔と同じ値 (例: 5s) に設定し、より短い時間範囲を表示します。最小間隔はクエリステップの下限のみを設定します。計算されたステップがすでに大きい場合、この設定は効果がありません。
関連操作
カスタム収集の編集
カスタム収集タスクを編集するには、リストで対象のタスクを見つけ、Operation 列の [設定の編集] をクリックし、カスタム収集タスクの編集 パネルで YAML コンテンツを変更します。
カスタム収集の削除
カスタム収集タスクを削除するには、リストで該当のタスクを見つけ、Operation 列の [削除] をクリックします。
カスタム収集の無効化
カスタム収集タスクを無効化するには、リストでそのタスクを見つけ、Operation 列の [無効化] をクリックします。無効化されたタスクはメトリクスのスクレイピングを停止します。