tencent cloud

Cloud Log Service

ドキュメントCloud Log Service操作ガイド指標ストレージ指標の事前集計

指標の事前集計

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-12 14:32:14
AI翻訳
指標監視データ量が多い場合やクエリが複雑な場合、リアルタイムクエリが遅くなることがあり、クエリ文の作成も困難です。この問題を解決するために、指標ストレージは事前集計機能をサポートしています。事前集計は複雑なクエリ（PromQL）を事前に計算し、結果を新しい指標として保存することをサポートします。これらの事前計算データは、後続のクエリやアラートで直接使用できるため、リアルタイム計算のオーバーヘッドを削減し、クエリ性能を向上させ、監視設定をよりシンプルかつ効率的にします。事前集計はPrometheus Recording Ruleと互換性があり、ネイティブのYAML設定ファイルを直接インポートできます。
例えば、元の指標prometheus_http_requests_totalには、prometheusの各インターフェースにおける異なるレスポンスステータスコード別のリクエスト回数が記録されています：
# HELP prometheus_http_requests_total Counter of HTTP requests.
# TYPE prometheus_http_requests_total counter
prometheus_http_requests_total{code="200",handler="/api/v1/label/:name/values"} 7
prometheus_http_requests_total{code="200",handler="/api/v1/query"} 19
prometheus_http_requests_total{code="200",handler="/api/v1/query_range"} 27
prometheus_http_requests_total{code="200",handler="/graph"} 11
prometheus_http_requests_total{code="200",handler="/metrics"} 8929
prometheus_http_requests_total{code="200",handler="/static/*filepath"} 52
prometheus_http_requests_total{code="302",handler="/"} 1
prometheus_http_requests_total{code="400",handler="/api/v1/query_range"} 6
日常的に各ステータスコードのリクエスト総数を確認する必要がある場合は、以下の設定を使用して事前集計タスクを作成できます：
groups:
  - name: example
    rules:
    - record: code:prometheus_http_requests_total:sum
      expr: sum by (code) (prometheus_http_requests_total)
ここで：
sum by (code) (prometheus_http_requests_total)は指標クエリ文（PromQL）であり、ステータスコード別にグループ化してリクエスト回数を合計します。
code:prometheus_http_requests_total:sumは生成された指標名であり、カスタマイズ可能です。その後、この名前を直接使用して計算済みの指標をクエリできます。

使用シナリオ

指標クエリ性能の向上：複雑なクエリを頻繁に実行する必要がある場合、事前集計を使用することでこれらのクエリを事前に計算し、新しい指標として保存できます。これにより、クエリ性能を大幅に向上させ、クエリ時間を短縮できます。
クエリ文の簡素化：複雑なクエリ文は非常に冗長で読みにくい場合があります。事前集計を使用することで、複雑なクエリ結果を簡素化された指標として保存できます。これにより、後続のクエリがよりシンプルになり、保守も容易になります。
コア指標の個別保存：指標トピック内のすべてのデータは同じ周期で保存され、期限切れ後に自動的に削除されます。一部のコア指標をより長期間保存する必要がある場合は、事前集計タスクを通じてこれらの指標データを他の指標トピックに保存できます。

前提条件

指標トピックが作成されました。

操作手順

新しいタスクの作成

1. CLSコンソールにログインします。
2. 左側のナビゲーションバーで指標トピックをクリックします。
3. 新しい事前集計タスクを作成する必要がある指標トピックのID/名前をクリックし、指標トピック管理ページに進みます。
4. 指標事前集計タブをクリックし、事前集計タスクリストページに進み、新しいタスクをクリックします。主な設定項目の説明は以下の通りです：
設定項目
説明
設定名
設定名を入力します。
サービスログ
タスクの実行ログをログトピックcls_service_logに保存し、タスクの実行状態を監視しやすくします。このログトピックは無料で、デフォルトで有効になっています。
実行ステートメント
実行する必要があるPromQLステートメントです。事前集計タスクはこのステートメントを定期的に実行し、実行結果を取得します。
指標名
実行ステートメントの結果をこの指標名で保存し、後でこの名前を使用してデータを照会します。英字、数字、下線、コロンに対応しており、正規表現[a-zA-Z_:][a-zA-Z0-9_:]*に準拠する必要があります。
カスタムディメンション
指標にディメンションを追加します。カスタムディメンションと実行ステートメントのクエリ結果内のディメンション名が競合する場合、カスタムディメンションが優先されます。
スケジュール周期
事前集計タスクの実行間隔です。1～1440分に対応しており、1分の使用を推奨します。
詳細設定
対象指標トピック：事前集計で得られた指標データの保存先であり、デフォルトでは現在のトピックです。このデータを個別に保存する必要がある場合（例えば、このデータの保存期間を個別に設定する必要がある場合）、データを他の指標トピックに保存できます。
遅延実行：指標データの収集には遅延が生じる可能性があります。事前集計タスクの実行時にデータが完全に収集されていることを保証するために、遅延実行を設定できます。デフォルトは30秒です。
5. 設定が完了したら、送信をクリックします。

設定ファイルのインポート

1. CLSコンソールにログインします。
2. 左側のナビゲーションバーで指標トピックをクリックします。
3. 新しい事前集計タスクを作成する必要がある指標トピックのID/名前をクリックし、指標トピック管理ページに進みます。
4. 指標事前集計タブをクリックし、事前集計タスクリストページに進み、設定ファイルをインポートをクリックします。主な設定項目の説明は以下の通りです：
設定項目
説明
設定名
設定名を入力します。
有効状態
タスクを実行する必要があるかどうかを指定します。実行しないタスクは事前集計結果データを生成しません。
サービスログ
タスクの実行ログをログトピックcls_service_logに保存し、タスクの実行状態を監視しやすくします。このログトピックは無料で、デフォルトで有効になっています。
実行間隔
事前集計タスクの実行間隔です。1～1440分に対応しており、1分の使用を推奨します。
YAML設定
Prometheus Recording Rule YAMLと互換性があります。intervalは1～1440分のみサポートされます。例：
groups:
  - name: example
    rules:
    - record: code:prometheus_http_requests_total:sum
      expr: sum by (code) (prometheus_http_requests_total)
詳細設定
対象指標トピック：事前集計で得られた指標データの保存先であり、デフォルトでは現在のトピックです。このデータを個別に保存する必要がある場合（例えば、保存期間を個別に設定する必要がある場合）、データを他の指標トピックに保存できます。
遅延実行：指標データの収集には遅延が生じる可能性があります。事前集計タスクの実行時にデータが完全に収集されていることを保証するために、遅延実行を設定できます。デフォルトは30秒です。
5. 送信をクリックして設定ファイルを保存すると、事前集計タスクが自動的に生成されます。タスク名はYAMLのgroup nameとrecordで構成されます。
説明：
設定ファイルによって自動生成された事前集計タスクは、設定ファイルを通じて変更する必要があります。直接の変更はサポートされていません。

設定ファイルの管理

1. CLSコンソールにログインします。
2. 左側のナビゲーションバーで指標トピックをクリックします。
3. 新しい事前集計タスクを作成する必要がある指標トピックのID/名前をクリックし、指標トピック管理ページに進みます。
4. 指標事前集計タブをクリックし、事前集計タスクリストページに進み、設定ファイルを管理をクリックします。
5. リストでは現在の設定ファイルを確認でき、操作列で設定ファイルを管理できます：
変更：設定ファイルを変更します。設定項目は設定ファイルをインポートと同じです。変更後、システムは最新の設定ファイルに基づいて事前集計タスクを自動的に調整します（設定ファイルに存在しなくなったタスクの削除、新しいタスクの追加、既存タスクの更新）。
一時停止：設定ファイルに対応する事前集計タスクを一時停止します。一時停止中、これらのタスクは実行されません。
削除：設定ファイルに対応する事前集計タスクを削除します。
前の記事へ: Prometheus-Compatible API次の記事へ: 検索分析の概要

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック

キーワードで検索
    Enter keywords to search documentation