Simple Log Service:LoongCollector 収集タグの管理

制限事項

• この機能は LoongCollector 3.0.10 以降でのみサポートされています。Logtail またはそれ以前のバージョンの LoongCollector を使用している場合は、最新バージョンの LoongCollector にアップグレードしてください。

• この機能はタグの名前とストレージの場所を変更します。ログ消費プロセスが変更されたタグフィールドに依存している場合、互換性の問題が発生する可能性があります。

タグの分類

タグフィールドはフィールドインデックスに似ており、キーと値が含まれています。たとえば、__tag__:__inode__:263554 では、__tag__:__inode__ がタグ名 (キー) で、263554 がタグ値です。

タグは、そのソースに基づいて主に 2 つのタイプに分類されます。

• エージェント関連: これらのタグは収集エージェント自体に関連しており、プラグインに依存しません。例としては、IP アドレスやホスト名などがあります。

• 入力プラグイン関連: これらのタグは入力プラグインに依存します。プラグインは、ファイルの inode、読み取りオフセット、ポッド名、名前空間、イメージ名などの関連情報でログを提供し、充実させます。

課金

タグフィールドは課金されません。ただし、インデックスフィールドとして設定すると料金が発生します。課金基準の詳細については、「課金」をご参照ください。フィールドインデックスの設定と削除の詳細については、「インデックスの作成」をご参照ください。

タグ名の作成または変更

LoongCollector はタグを標準化し、タグ処理機能を提供します。高度なパラメーターを構成して、タグを追加、削除、名前変更できます。

タグの削除

タグを削除するには、高度なパラメーター構成でその値を空の文字列に設定します。

次の例では、AGENT_TAG の値が空の文字列に設定されているため、タグは表示されません。詳細については、「タグ名の作成または変更」をご参照ください。

{
  "PipelineMetaTagKey": {
    "HOST_NAME": "sourceName",
    "AGENT_TAG": "",
    "HOST_ID": "__default__",
    "CLOUD_PROVIDER": "__default__"
  }
}

タグの表示

1. [プロジェクト] セクションで、目的のプロジェクトをクリックします。

   

2. ターゲット Logstore の右側にある アイコンをクリックし、[クエリと分析] を選択して現在の Logstore のログを表示します。

   

3. 次の図に示すように、タグフィールドはログページの最上部に表示されます。

   

   • エージェント関連タグ

     • __tag__:sourceName: タグキーは PipelineMetaTagKey.HOST_NAME に設定されます。デフォルト値は __tag__:__hostname__ です。この例では、値は __tag__:sourceName に設定されており、ソースホスト名を表します。

     • __tag__:__host_id__: タグキーは PipelineMetaTagKey.HOST_ID に設定されます。このパラメーターにはデフォルト値 __host_id__ が使用されます。

     • __tag__:__cloud_provider__: タグキーは PipelineMetaTagKey.CLOUD_PROVIDER に設定されます。このパラメーターにはデフォルト値 __cloud_provider__ が使用されます。

     • __tag__:__user_defined_id__: タグキーは AGENT_TAG に設定されます。このパラメーターは、カスタム識別子を持つマシングループにのみ適用され、IP アドレスを持つマシングループには適用されません。

   • 入力プラグイン関連タグ

     • __tag__:__inode__: タグキーは Tags.FileInodeTagKey に設定されます。このパラメーターにはデフォルト値 __inode__ が使用されます。

     • __tag__:__path__: タグキーは Tags.FilePathTagKey に設定されます。このパラメーターにはデフォルト値 __path__ が使用されます。

     • __file_offset__: タグキーは FileOffsetKey に設定されます。このパラメーターにはデフォルト値 __file_offset__ が使用されます。

       重要

       • 入力構成で FileOffsetKey を設定すると、収集構成の [インデックスの自動生成] 機能によって、このタグフィールド (__file_offset__) がインデックスフィールドとして設定されます。課金の詳細については、「課金」をご参照ください。このフィールドのインデックスを作成する必要がない場合は、インデックスを削除してタグフィールドを保持できます。詳細については、「インデックスの更新」をご参照ください。

       • このタグはクエリ分析ページの上部には表示されません。固有のプロパティと機能を持ち、名前は __file_offset__ です。次の図に例を示します。

         

タグ値の変更

構造化プロセス言語 (SPL) 処理プラグインを使用して、タグフィールドを管理し、タグ値を変更できます。SPL を使用してタグフィールドを処理する場合は、次のルールに従ってください。

1. SPL は __tag__: プレフィックスを使用してタグを識別し、処理中にこのプレフィックスをすべてのタグフィールドに自動的に追加します。したがって、SPL 文を記述するときは、タグ関連のデータを正しく参照するために、フィールド名にこのプレフィックスが含まれていることを確認してください。

2. SPL 出力では、タグプレフィックスを持つすべてのフィールドがタグとして識別されます。このメソッドを使用してタグを追加できます。

このトピックでは、__tag__ :sourceName を例として、収集構成を変更するときに SPL 文を追加する方法について説明します。ログをより簡単にクエリするために、ログ収集構成で値を user_module に変更して、アプリケーション名で異なるログを区別できます。収集構成を作成するときに SPL 文を追加する方法の詳細については、「収集構成を作成するときに SPL 文を追加する」をご参照ください。

1. [プロジェクト] セクションで、目的のプロジェクトをクリックします。

   

2. [ログストレージ] > [Logstores] タブで、目的の Logstore の横にある > アイコンをクリックし、[データ収集] > [Logtail 構成] を選択します。

   

3. [Logtail 構成] リストで、必要な Logtail 構成を見つけ、[アクション] 列の [Logtail 構成の管理] をクリックします。

4. ページ上部の [編集] をクリックします。ページ下部の [処理構成] セクションで、[処理構成] の [処理モード] を [SPL] に設定し、[保存] をクリックします。

   SPL 文を次のように設定します: * | extend "__tag__:sourceName"='user_module'

5. ターゲット Logstore の右側にある アイコンをクリックし、[クエリと分析] を選択して現在の Logstore のログを表示します。

   __tag__:sourceName フィールドの値は user_module です。

   

リファレンス

通常のインデックスフィールドをタグフィールドとして設定できます。タグフィールドは表示または非表示にできます。詳細については、「タグフィールド」をご参照ください。