tencent cloud

Tencent Cloud EdgeOne

ドキュメントTencent Cloud EdgeOneデータ分析とCLSログサービス関連参考カスタムログ出力フォーマット

カスタムログ出力フォーマット

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-16 11:38:31
AI翻訳

機能概要

ユーザーによるログデータの出力形式のカスタマイズをサポートします。これには、さまざまなログ記録スタイルの選択（JSON Lines、CSV、またはカスタム形式など）や、バッチおよび単一ログの前後缀、ログレコードまたはフィールド間の区切り文字の定義が含まれます。リアルタイムログとオフラインログのデフォルト形式はJSON Linesです。

設定項目

リアルタイムログのログ出力形式は、「プリセット形式」と「カスタム形式」の2種類に分けられます：
プリセット形式（JSON Lines、CSV）：標準化されたフォーマットで、すべての詳細パラメータが固定されており、すぐに使用できます。
カスタム形式：「基本形式」（Key-Value、Valueのみ、テンプレートで定義）を明示的に選択でき、1回のログプッシュリクエストのデータ形式を詳細に制御できます。これにはバッチディメンション（バッチ前後缀、ログ区切り文字）と単一ログディメンション（単一前後缀、フィールド区切り文字）が含まれます。

ログ出力フォーマット

ログ出力形式：ログ配信の出力形式タイプ。
JSON Lines：JSON Lines（NDJSON）形式仕様です。各行は有効なJSONオブジェクトであり、1件のログ内のフィールドはJSON構文に従ってキーと値のペアで表現されます。
CSV：CSV（RFC 4180）形式仕様です。カンマでフィールドを区切り、各レコードは1行を占め、フィールド値は固定順序で並び、フィールド名は含まれません。
カスタム：1件のログの表示形式は「基本形式」によって決まります。カスタムを選択した後、さらに基本形式を選択する必要があります。
基本形式（ログ出力形式が「カスタム」の場合のみ設定可能）：1件のログにおけるフィールドの表示スタイル。
Key-Value：キーと値のペアで1件のログを表示します。
Valueのみ：フィールド値のみを表示し、フィールド名は表示しません。
テンプレートで定義：カスタムテンプレートを使用して1件のログ内容を定義します。${フィールド名}によるプリセットフィールドまたはカスタムフィールドの参照をサポートします。

細分化パラメータ

カスタム出力形式で調整可能な詳細パラメータは以下の通りです。
バッチディメンション：1回のログプッシュリクエスト（1バッチ）のデータ形式を制御します。
バッチ前後缀：ユーザーはログバッチにプレフィックスとサフィックスを定義できます。「1つのバッチ」とは1回のログプッシュリクエストを指し、各ログ配信バッチには複数のログレコードが含まれる場合があります。
プレフィックス：各ログ配信バッチの前に追加される文字列。
サフィックス：各ログ配信バッチの後に追加される文字列。
ログ区切り文字：ログレコードの間に区切り文字として挿入される文字列。
単一ログディメンション：バッチ内の単一ログレコードのデータ形式を制御します。
単一ログのプレフィックスとサフィックス：各ログレコードの前後に文字列を追加します。
プレフィックス：各ログレコードの前に追加される文字列。
サフィックス：各ログレコードの後に追加される文字列。
フィールド区切り文字：単一ログレコード内で、フィールド間に区切り文字として挿入される文字列。
説明：
1. 在未开启日志采样或 筛选 的情况下、对于域名业务而言、一次 HTTP 请求对应一条日志记录。
2. カスタム式フィールドは定義時の順序で上から下にログに出力されます。カスタムフィールドの出力順序を変更する必要がある場合は、ログ出力形式を「カスタム → テンプレートで定義」に切り替えて、テンプレート内でフィールドの並び順を指定してください。
3. 重複フィールド名の出力動作：複数のフィールドに同じ keyname が定義されている場合：
KV形式（JSON Lines、カスタムKey-Value形式）：優先度が最も高い1つのフィールドのみを出力します。
Valueのみの形式（CSV、カスタムValueのみの形式）：定義回数に従って繰り返し出力され、値は統一して最高優先度に従います。
フィールド値上書きの優先順位：カスタム式フィールド > 既存4分類のカスタムフィールド > プリセットフィールド。

サンプル設定

以下は、異なるログ出力形式設定に対応するログサンプルです。

JSON Lines

設定サンプル

設定項目
値
ログ出力形式
JSON Lines
単一ログプレフィックス
{
単一ログサフィックス
}
ログ区切り文字
\\n
フィールド区切り文字
,

出力ログサンプル

{"SecurityAction":"Deny","RequestID":"14941044941971548881","RequestTime":"2024-08-12T08:12:15Z","ClientIP":"1.1.1.1"}
{"SecurityAction":"Deny","RequestID":"14941045941971548882","RequestTime":"2024-08-12T08:12:30Z","ClientIP":"2.2.2.2"}

CSV

設定サンプル

設定項目
値
ログ出力形式
CSV
ログ区切り文字
\\n
フィールド区切り文字
,

出力ログサンプル

Deny,14941044941971548881,2024-08-12T08:12:15Z,1.1.1.1
Deny,14941045941971548882,2024-08-12T08:12:30Z,2.2.2.2

カスタマイズ

Key-Value サンプル

JSON 配列形式の設定サンプル
設定項目
値
ログ出力形式
カスタム
基本形式
Key-Value
バッチプレフィックス
[
バッチサフィックス
]
単一ログプレフィックス
{
単一ログサフィックス
}
ログ区切り文字
,
フィールド区切り文字
,
JSON 配列形式の出力ログサンプル
[
    {"SecurityAction":"Deny","RequestID":"14941044941971548881","RequestTime":"2024-08-12T08:12:15Z","ClientIP":"1.1.1.1"},
    {"SecurityAction":"Deny","RequestID":"14941045941971548882","RequestTime":"2024-08-12T08:12:30Z","ClientIP":"2.2.2.2"},
    {"SecurityAction":"Allow","RequestID":"14941046941971548883","RequestTime":"2024-08-12T08:12:45Z","ClientIP":"3.3.3.3"}
]
ネストされた JSON オブジェクト形式の設定サンプル
設定項目
値
ログ出力形式
カスタム
基本形式
Key-Value
バッチプレフィックス
{"events":[
バッチサフィックス
]}
単一ログプレフィックス
{"info":{
単一ログサフィックス
}}
ログ区切り文字
,
フィールド区切り文字
,
ネストされた JSON オブジェクト形式の出力ログサンプル
{"events": [
        {"info": {"SecurityAction":"Deny","RequestID":"14941044941971548881","RequestTime":"2024-08-12T08:12:15Z","ClientIP":"1.1.1.1"}},
        {"info": {"SecurityAction":"Deny","RequestID":"14941045941971548882","RequestTime":"2024-08-12T08:12:30Z","ClientIP":"2.2.2.2"}}
]}

Value のみのサンプル

CSV ヘッダー行あり形式の設定サンプル
設定項目
値
ログ出力形式
カスタム
基本形式
Valueのみ
バッチプレフィックス
SecurityAction,RequestID,RequestTime,ClientIP\\n
ログ区切り文字
\\n
フィールド区切り文字
,
CSV ヘッダー行あり形式の出力ログサンプル
SecurityAction,RequestID,RequestTime,ClientIP
Deny,14941044941971548881,2024-08-12T08:12:15Z,1.1.1.1
Deny,14941045941971548882,2024-08-12T08:12:30Z,2.2.2.2
Allow,14941046941971548883,2024-08-12T08:12:45Z,3.3.3.3

TSV 形式の設定サンプル

設定項目
値
ログ出力形式
カスタム
基本形式
Valueのみ
ログ区切り文字
\\n
フィールド区切り文字
\\t

TSV 形式の出力ログサンプル

Deny  14941044941971548881  2024-08-12T08:12:15Z  1.1.1.1
Deny  14941045941971548882  2024-08-12T08:12:30Z  2.2.2.2
Allow  14941046941971548883  2024-08-12T08:12:45Z  3.3.3.3

テンプレート定義のサンプル

設定サンプル
設定項目
値
ログ出力形式
カスタム
基本形式
テンプレートで定義します。
ログ区切り文字
\\n
単一ログ内容テンプレート
{"SecurityAction":"${SecurityAction}","ClientIP":"${ClientIP}","RequestID":"${RequestID}","RequestTime":"${RequestTime}","CustomField":"${custom_field_name}","Timestamp":"${timestamp}","Source":"EO"}
出力ログサンプル
{ "SecurityAction":"Deny", "ClientIP":"1.1.1.1", "RequestID":"14941044941971548881", "RequestTime":"2024-08-12T08:12:15Z", "CustomField":"my_value", "Timestamp":"1723450335", "Source":"EO" }
{ "SecurityAction":"Deny", "ClientIP":"2.2.2.2", "RequestID":"14941045941971548882", "RequestTime":"2024-08-12T08:12:30Z", "CustomField":"my_value", "Timestamp":"1723450350", "Source":"EO" }

利用制限

ログ出力形式の機能は、プラン、ログタイプ、配信先によって制限されます。具体的には以下の通りです：
プラン
サブ機能
無料版
パーソナル版
ベーシック版
スタンダード版
エンタープライズ版
プリセット形式（JSON Lines、CSV）
✓
✓
✓
✓
✓
カスタム形式（Key-Value、Valueのみ）
✓
✓
✓
✓
✓
カスタム形式（テンプレートで定義）
✕
✕
✕
✕
✓
ログタイプ
L7アクセスログ、L4プロキシログ：プリセット形式（JSON Lines、CSV）およびカスタム形式（Key-Value、Valueのみ、テンプレートで定義）を含む、完全なログ出力形式機能をサポートします。
エッジ関数実行ログ：プリセットJSON Lines形式およびカスタムKey-Value形式のみをサポートします。
マネージドルールログ：ログ出力形式の設定は現在サポートされていません。
ログ配信先
CLS、EOのログ分析はJSON Lines形式のみをサポートしており、CSVまたはカスタム形式に切り替えることはできません。










前の記事へ: カスタムプッシュログフィールド次の記事へ: 概要

ヘルプとサポート

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

フィードバック

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