tencent cloud

Cloud Log Service

検索分析

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-12 14:07:52
AI翻訳

ログトピック

日志主题检索分析规格限制如下表:
カテゴリー
制限項目
説明
インデックス
フィールド数
1つのログトピックのキー値インデックスには、最大300個のフィールドを追加できます(メタデータフィールドを含む)。
フィールド名称
*\\",を除くすべての英文字、記号および数字をサポートします。ただし、_で始めることはできません(__CONTENT__フィールドを除く)。
JSONの親子フィールドを同時に含めることはできません。例えば、aおよびa.bです。
フィールド階層
多階層JSONにキー値インデックスを設定する場合、Keyの階層は10階層を超えることはできません。例えば、a.b.c.d.e.f.g.h.j.kです。
分かち書き文字
英語記号、\\n\\t\\rおよびエスケープ文字\\のみをサポートします。
フィールド長
検索制限:各フィールドの先頭1MBのログのみが検索対象となります。1MBを超えた部分は検索できません。
統計制限:統計を有効にすると、各フィールドの先頭32766バイトのみがSQL演算の対象となります。この制限を超えた部分はSQLを実行できません。
上記の制限を超えたログフィールドは、引き続き完全に保存され、表示やダウンロードが可能です。ただし、制限を超えた部分は検索や統計ができません。
分かち書き長
分詞後、単一の語は先頭の10000文字のみが検索に使用され、それを超える部分は検索を実行できませんが、ログは引き続き完全に保存されます。
数値フィールド精度
および範囲
long型フィールドがサポートするデータ範囲は-1E15~1E15です。この範囲を超えたデータは精度が失われるか、検索がサポートされない可能性があります。
double型フィールドがサポートするデータ範囲は-1.79E+308~+1.79E+308です。浮動小数点数のエンコード桁数が64ビットを超えると、精度が失われます。
超長数値フィールドのインデックス設定に関する推奨事項:
このフィールドを数値範囲比較で検索する必要がない場合は、このフィールドをtext型として保存できます。
数値範囲比較でこのフィールドを検索する必要がある場合は、このフィールドをdouble型として保存できます。ただし、一部の精度が失われる可能性があります。
有効化メカニズム
インデックス設定は新しく収集されたデータにのみ有効です。インデックスルールを編集した後は、新しく書き込まれたログにのみ有効です。既存のデータは更新されません。既存のデータを更新する必要がある場合は、インデックスを再構築する必要があります。
インデックス設定の変更
インデックス設定の作成、変更、削除を行う際、1人のユーザーが同時に保有できる実行中のタスクは最大10個です。上限を超えた場合は、前のタスクの実行が完了するまで待つ必要があります。1つのタスクの実行には通常1分以内です。
インデックス再構築
1つのログトピックでは同時に1つのインデックス再構築タスクのみ実行できます。1つのログトピックには同時に最大10件のインデックス再構築タスクレコードを保持できます。不要になったタスクレコードを削除した後にのみ、新しいインデックスタスクを作成できます。
同一時間範囲内のログに対してインデックスの再構築は1回のみ許可されます。再度再構築するには、以前のタスクレコードを削除する必要があります。
選択した時間範囲に対応するログの書き込みトラフィックは5TBを超えることはできません。
インデックス再構築の時間範囲はログ時間に準じます。ログのアップロード時間とインデックス再構築の時間範囲に1時間以上のずれがある場合(例えば16:00に02:00のログをCLSにアップロードし、00:00~12:00のログインデックスを再構築する場合)、そのログは再構築されず、以降検索できません。既に再構築されたログ時間範囲に新しいログをアップロードした場合も、再構築されず、以降検索できません。
クエリ
ステートメント長
検索分析ステートメントは最大12000文字までサポートします。
クエリ同時実行数
1つのログトピックは、検索と分析を含む15の同時実行をサポートします。
あいまい検索
プレフィックスあいまい検索はサポートされていません。例えば、*rrorでerrorを検索することはできません。
フレーズ検索
フレーズ検索のワイルドカードは、条件に一致する最大128個の語にのみ一致します。これらの128個の語を含むすべてのログが返されます。指定する語が正確であるほど、検索結果も正確になります。
ロジックグループのネスト深度
CQL構文ルールで括弧を使用して検索条件を論理グループ化する場合、最大10階層までネストできます。Lucene構文ルールにはこの制限はありません。
例えば、(level:ERROR AND pid:1234) AND service:testは2階層のネストであり、正常に検索を実行できます。一方、以下のステートメントは11階層のネストであり、検索を実行するとエラーが発生します。status:"499" AND ("0.000" AND (request_length:"528" AND ("https" AND (url:"/api" AND (version:"HTTP/1.1" AND ("2021" AND ("0" AND (upstream_addr:"169.254.128.14" AND (method:"GET" AND (remote_addr:"114.86.92.100"))))))))))
メモリ使用量(分析)
統計分析で毎回使用するサーバーメモリは3GBを超えることはできません。
通常、group by、distinct()、count(distinct())を使用する際にこの制限が発生する可能性があります。これは、統計対象のフィールドがgroup byまたはdistinct()による重複排除後に値が多すぎることが原因です。クエリ文を最適化し、より値の少ないフィールドでデータをグループ化して統計することをお勧めします。または、count(distinct())の代わりにapprox_distinct()を使用してください。
クエリ結果
クエリ結果が生ログの場合、1回で最大1000件の生ログが返されます。
クエリ結果が統計分析結果の場合、デフォルトでは1回に100件の結果を返します。SQL LIMIT 構文を使用すると、1回で最大100万件の結果を返すことができます。
クエリ結果として返されるデータパケットは最大49MBです。APIを使用する場合は、gzip圧縮を有効にできます(Header Accept-Encoding:gzip)。
タイムアウト時間
1回のクエリタイムアウト時間は55秒で、検索と分析を含みます。
クエリ遅延
ログが報告されてから検索・分析可能になるまでの遅延は1分未満です。
ダウンロード
ログ件数
1回のダウンロードにおけるログ件数は最大5000万件です。
タスク数
1つのログトピックにつき、最大2つのタスクが「ファイル生成中」状態になります。その他の未完了タスクは「待機中」状態となり、実行を待つためにキューに入ります。
1つのログトピックには、同時に最大1000個のタスクが存在できます。これには、「ファイル生成済み」状態の完了済みタスクも含まれます。
ファイル保存期間
生成されたログファイルは3日間のみ保持されます。
外部データの関連付け
数量制限
1つのログトピックに最大20個の外部データを関連付けることができます。
クエリタイムアウト
外部データベースをクエリする場合、タイムアウト時間は50秒です。
MySQL バージョン
MySQL 5.7、8.0およびそれ以降のバージョンと互換性があります。MySQL 5.6は完全な互換性テストを実施していないため、実際にSQL文が正常に実行されるかどうかを検証する必要があります。
CSV ファイルサイズ
50MBを超えることはできず、圧縮には対応していません。

指標トピック

指標トピックの検索分析仕様制限は以下の表の通りです:
制限項目
説明
クエリ同時実行数
1つの指標テーマは15同時実行をサポートします。
クエリデータ量
1回のクエリで対象となる time series は20万を超えず、クエリ結果内の単一 time series は最大1.1万個の時点です。
タイムアウト時間
1回のクエリタイムアウト時間は55秒で、検索と分析を含みます。

ヘルプとサポート

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

フィードバック