tencent cloud

Tencent Cloud EdgeOne

DocumentaçãoTencent Cloud EdgeOneデータ分析とCLSデータ分析関連参考APIを使用した単一呼び出しでのグループ化クエリの実装方法

APIを使用した単一呼び出しでのグループ化クエリの実装方法

Baixar
Modo Foco
Tamanho da Fonte
Última atualização: 2026-10-16 11:38:31
Traduzido por IA
EdgeOneデータ照会インターフェースは、返却データのグループ化ディメンションを指定するためにDimensionNameパラメータを渡すことをサポートしています。これにより、1回の照会で複数のグループ化データを取得でき、API呼び出し頻度を大幅に削減し、統計データ取得の操作を簡素化できます。例えば、ある呼び出しでDimensionName = domainを渡すと、返却データはドメインごとに1グループずつ返されます。

適用範囲

グループ化照会機能は以下のAPIに適用されます:

使用シナリオ

以下のシナリオでは、DimensionNameとFiltersパラメータを組み合わせて、効率的かつ柔軟なデータ取得を実現する方法を示します。大量のドメインや詳細なステータスコードを含むクエリでは、まずFiltersを使用して事前フィルタリングを行い、適切なクエリ粒度(Interval)を選択することをお勧めします。

シナリオ1:複数ドメインデータの一括取得

1回のリクエストで複数ドメインの指標データを同時に照会し、ドメインごとに個別の呼び出しを行うことを回避します。
入力パラメータ例
{
"ZoneIds": ["*"],
"MetricNames": ["l7Flow_inFlux_hy"],
"StartTime": "2025-12-01T00:00:00Z",
"EndTime": "2025-12-02T00:00:00Z",
"Interval": "hour",
"Filters": [
{
"Key": "domain",
"Operator": "equals",
"Value": ["example.com", "api.example.com"]
}
],
"DimensionName": "domain"
}

シナリオ2:ステータスコードカテゴリ別の集計分析

オリジン応答ステータスコードの大分類(2xx、4xx、5xxなど)ごとにグループ化された集計データを取得します。
入力パラメータ例
{
"ZoneIds": ["*"],
"MetricNames": ["l7Flow_request_hy"],
"StartTime": "2025-12-01T00:00:00Z",
"EndTime": "2025-12-01T12:00:00Z",
"Interval": "hour",
"Filters": [
{
"Key": "originStatusCode",
"Operator": "equals",
"Value": ["2xx", "4xx", "5xx"]
}
],
"DimensionName": "origin-status-code-category"
}

利用制限

1回のリクエストで返されるデータ項目TimingDataItemは最大50,000件です。データ項目の総数の計算ルールは以下の通りです:
指標数 × 時点数 × ディメンション値数 = データ項目総数
指標数:MetricNamesのリスト長です。
時点数:(EndTime - StartTime) / Intervalです。
ディメンション値の数:
DimensionNameが指定されていない場合、デフォルトではアカウントディメンションでデータを集計し、ディメンション値の数は1です。
DimensionName = domainの場合、ディメンション値の数はFiltersのdomainフィルタ条件で指定されたドメインリストの長さです。
DimensionName = origin-status-code-categoryの場合、ディメンション値の数はデフォルトで6です。
DimensionName = origin-status-codeの場合、ディメンション値の数はデフォルトで600です。
DimensionNameはFiltersと組み合わせて使用できます。FiltersでDimensionNameに対応するフィルタ条件を指定することで、ディメンション値の数を制限します。

例

ある1時間の具体的なステータスコードディメンションの時系列データをクエリする場合を例にすると、クエリ条件は以下の通りです:
MetricNames = ["l7Flow_request_hy"](指標数 = 1)
StartTime = 2025-10-01T06:00:00+08:00、EndTime = 2025-10-01T06:59:59+08:00、Interval = "min"(時点数 = 60)
DimensionName = origin-status-code、Filters = [{"originStatusCode": ["0", "4xx", "5xx"]}](ディメンション値の数 = 201)
データ項目の総数は以下の通りです:
1 × 60 × 201 = 12060
制限を超えていません。
注意:
クエリ対象のデータ項目の総数が50,000を超える場合、システムはエラーLimitExceeded.TimingDataItemLimitExceededを返します。
この場合、入力を調整して1回のクエリのデータ項目を50,000以内に減らしてください。対応方法は以下の通りです:
1. 時点数を減らします:
クエリの時間範囲(StartTimeからEndTimeまでの時間スパン)を短縮してください。
より大きい時間間隔(Interval)を選択してください。
2. ディメンション値の数を減らします:
Filtersを調整し、より少ないdomainまたはoriginStatusCodeのリストを指定してください。
3. 指標値の数を減らします:
MetricNamesを調整し、より少ないクエリ指標を指定してください。

Ajuda e Suporte

Esta página foi útil?

comentários