予約フィールドの概要 - Simple Log Service (SLS)

ログを収集したり、他のクラウドサービスにデータを配布したりすると、Simple Log Service はログソースやタイムスタンプなどの情報をキーと値のペアとしてログに追加します。これらは Simple Log Service の予約済みフィールドです。

重要

API を使用してログデータを書き込む場合や Logtail を設定する場合は、カスタムフィールドに予約済みフィールド名を使用しないでください。これにより、フィールド名の競合を防ぎ、正確なクエリ結果を保証します。
__tag__ プレフィックスを持つフィールドの配布は、レガシー配布タスクではサポートされていません。
ご利用の Logstore が取り込みデータ量課金モードを使用している場合、Simple Log Service がログに追加する予約済みフィールドに対しては課金されません。詳細については、「取り込みデータ量課金」をご参照ください。
ご利用の Logstore が機能別課金モードを使用している場合、追加された予約済みフィールドに対して料金が発生します。これらのフィールドのインデックスを有効にすると、インデックストラフィックとストレージに対して少額の料金も発生します。詳細については、「機能別課金」をご参照ください。

予約済みフィールド	タイプ	インデックスと分析	説明
`__time__`	整数。標準の UNIX タイムスタンプです。	`__time__` フィールドは、API 呼び出しで from および to パラメーターを使用して時間範囲を指定するために使用されます。このフィールドのインデックスを作成する必要はありません。 `__time__` ログ分析構成：他の任意のフィールドでログ分析が有効になっている場合、このフィールドでも自動的に有効になります。	ログが書き込まれるときに指定されるログのタイムスタンプです。このフィールドは、ログの配布、クエリ、分析に使用できます。
`__source__`	文字列。	`__source__source:127.0.0.1__source__:127.0.0.1`インデックス構成：インデックス作成が有効になると、Simple Log Service は自動的にこのフィールドのインデックスを作成します。インデックスのデータの型はテキストで、デリミタはありません。ログをクエリするには、またはを使用します。 `__source__` ログ分析の構成：他のフィールドでログ分析が有効になっている場合、このフィールドでも自動的に有効になります。	ログのソース (IP アドレスやマシン識別子など) です。このフィールドは、ログの配布、クエリ、分析、カスタム消費に使用できます。
`__topic__`	文字列。	`__topic____topic__:XXX`インデックス構成：インデックス作成が有効になると、Simple Log Service は自動的にこのフィールドのインデックスを作成します。インデックスのデータの型はテキストで、デリミタはありません。ログをクエリするには、を使用します。 `__topic__`ログ分析の構成：他のいずれかのフィールドでログ分析が有効になっている場合、このフィールドでも自動的に有効になります。	`__topic__`ログのトピック。ログにトピックを設定すると、Simple Log Service がこのフィールドを自動的に追加します。キーは '__topic__' で、値は指定されたトピックの内容です。このフィールドは、ログ配布、クエリ、分析、およびカスタム消費に使用できます。詳細については、「トピック」をご参照ください。
`_extract_others_`	JSON マップに逆シリアル化できる文字列です。	このフィールドはログの内容には存在しません。インデックスを作成する必要はありません。	`__extract_others____extract_others__`このフィールドは、のエイリアスです。の使用を推奨します。
`__tag__:__client_ip__`	文字列。	インデックス設定：インデックス作成が有効になっている場合、Simple Log Service は自動的にすべてのタグフィールドのインデックスを作成します。インデックスのデータ型はテキストで、デリミタはありません。このフィールドに対して、完全一致またはあいまい一致クエリを実行できます。 `__tag__:__client_ip__`ログ分析構成：このフィールドに対するログ分析はデフォルトで無効です。ログ分析を有効化するには、手動でインデックスを作成し、ログ分析機能を有効化する必要があります。	ログソースのパブリック IP アドレスのシステムタグです。パブリック IP アドレスの記録が有効になっている場合、サーバーは受信時にこのフィールドを生ログに追加します。このフィールドは、ログのクエリ、分析、カスタム消費に使用できます。SQL 分析でこのフィールドを使用する場合は、フィールド名を二重引用符 ("") で囲む必要があります。詳細については、「タグ」および「パブリック IP アドレスの記録」をご参照ください。
`__tag__:__receive_time__`	文字列。値は、UNIX タイムスタンプを表す整数に変換できます。	インデックス設定：インデックス作成が有効になっている場合、Simple Log Service は自動的にすべてのタグフィールドのインデックスを作成します。インデックスのデータ型はテキストで、デリミタはありません。このフィールドに対して、完全一致またはあいまい一致クエリを実行できます。 `__tag__:__receive_time__` ログ分析構成: このフィールドでは、デフォルトでログ分析が無効になっています。ログ分析を有効にするには、手動でインデックスを作成し、ログ分析機能を有効にする必要があります。	ログがサーバーに到着した時刻のシステムタグです。パブリック IP アドレスの記録が有効になっている場合、サーバーは受信時にこのフィールドを生ログに追加します。このフィールドは、ログのクエリ、分析、カスタム消費に使用できます。詳細については、「タグ」および「パブリック IP アドレスの記録」をご参照ください。
`__tag__:__path__`	文字列。	`__tag__:__path____tag__:__path__:XXX`インデックス構成: インデックスが有効になっている場合、Simple Log Service はそのフィールドのインデックスを自動的に作成します。インデックスのデータの型はデリミタなしのテキストです。ログをクエリするには、を使用します。 `__tag__:__path__` ログ分析構成：このフィールドでは、デフォルトでログ分析が無効になっています。ログ分析を有効にするには、手動でインデックスを作成してログ分析機能を有効にする必要があります。	Logtail が収集時に自動的に追加するログファイルの完全なパスです。このフィールドは、ログのクエリ、分析、カスタム消費に使用できます。SQL 分析でこのフィールドを使用する場合は、フィールド名を二重引用符 ("") で囲む必要があります。
`__tag__:__hostname__`	文字列。	`__tag__:__hostname____tag__:__hostname__:XXX`インデックス構成: インデックス作成を有効にすると、Simple Log Service はこのフィールドのインデックスを自動的に作成します。インデックスのデータの型は、デリミタなしのテキストです。ログをクエリするには、この形式を使用します。 `__tag__:__hostname__` のインデックスを作成し、ログ分析機能を有効にする必要があります。	Logtail がデータを収集するマシンのホスト名で、Logtail が自動的に追加します。このフィールドは、ログのクエリ、分析、カスタム消費に使用できます。SQL 分析でこのフィールドを使用する場合は、フィールド名を二重引用符 ("") で囲む必要があります。
`__raw_log__`	文字列。	このフィールドのインデックスは手動で作成する必要があります。インデックスのデータ型をテキストに設定し、必要に応じてログ分析を有効にします。	`__raw_log__`解析が失敗した場合の生ログが含まれます。「ログ解析失敗時の破棄」機能を無効にすると、Logtail はこのフィールドに生ログをアップロードします。このフィールドは、ログの配布、クエリ、分析、カスタム消費に使用できます。詳細については、「ログ解析失敗時の破棄」をご参照ください。
`__raw__`	文字列。	このフィールドのインデックスは手動で作成する必要があります。インデックスのデータ型をテキストに設定し、必要に応じてログ分析を有効にします。	`__raw__`解析が成功した後の元の生ログが含まれます。「生ログのアップロード」機能を有効にすると、Logtail は解析されたデータとともに、このフィールドに生ログの内容を含めます。これは、監査やコンプライアンスのシナリオで役立ちます。このフィールドは、ログの配布、クエリ、分析、カスタム消費に使用できます。詳細については、「生ログのアップロード」をご参照ください。