すべてのプロダクト
Search
ドキュメントセンター

Simple Log Service:UpdateLogtailPipelineConfig

最終更新日:Sep 18, 2026

Logtail パイプライン構成を更新します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

log:UpdateLogtailPipelineConfig

update

*すべてのリソース。

*

  • log:TLSVersion
なし

リクエスト構文

PUT /pipelineconfigs/{configName} HTTP/1.1

パスパラメーター

パラメーター

型

必須 / 任意

説明

例

configName

string

必須

Logtail パイプライン構成名。

test-config

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

project

string

必須

プロジェクト名。

test-project

body

object

任意

Logtail パイプライン構成内容。

aggregators

array<object>

任意

集約プラグインのリスト。

重要 このパラメーターは、拡張処理プラグインが使用されている場合にのみ効果があります。集約プラグインの最大値は 1 です。

object

任意

集約プラグイン。

configName

string

必須

構成名。

重要 値は、外側の configName パラメーターと同じである必要があります。

test-config

flushers

array<object>

必須

出力プラグインのリスト。

重要 Simple Log Service 出力プラグインは 1 つのみ許可されます。

object

任意

出力プラグイン。

{ "Type": "flusher_sls", "Logstore": "test" }

global

object

任意

一般設定。

inputs

array<object>

必須

入力プラグインのリスト。

重要 入力プラグインは 1 つのみ構成できます。

object

任意

入力プラグイン。

説明

ファイル入力プラグインのパラメーターについては、「ファイルプラグイン」を参照してください。その他の入力プラグインのパラメーターについては、「処理プラグイン」を参照してください。

{ "Type": "input_file", "FilePaths": ["/var/log/*.log"] }

logSample

string

任意

ログサンプル。複数のログエントリがサポートされています。

2022-06-14 11:13:29.796 | DEBUG | __main__::1 - hello world

processors

array<object>

任意

処理プラグインのリスト。

説明

処理プラグインは、ネイティブ処理プラグインと拡張処理プラグインに分類されます。詳細については、「処理プラグイン」を参照してください。

重要
説明
  • ネイティブプラグインは、テキストフォーマットのログの収集にのみ使用できます。

  • ネイティブプラグインと拡張プラグインを同時に追加することはできません。

  • ネイティブプラグインを使用する場合は、以下の要件を満たす必要があります。
    • 最初の処理プラグインは、正規表現解析プラグイン、デリミタ解析プラグイン、JSON 解析プラグイン、NGINX モード解析プラグイン、Apache モード解析プラグイン、または IIS モード解析プラグインである必要があります。

    • 最初の処理プラグインの後には、時間解析プラグイン 1 つ、フィルタープラグイン 1 つ、および複数のデータマスキングプラグインのみが許可されます。

object

任意

処理プラグイン。

説明

詳細については、「処理プラグイン」を参照してください。

{ "Type": "processor_parse_json_native", "SourceKey": "content" }

task

object

任意

一般設定

パラメータータイプ必須デフォルト値例説明
TopicTypestringNoEmptyfilepathトピックタイプ。有効な値:
  • filepath: ログファイルパスから情報を抽出してトピックとします。この値は、入力プラグインが input_file の場合にのみ効果があります。

  • machine_group_topic: この構成が適用されるマシングループのトピックをトピックとして使用します。

  • custom: カスタムトピックを使用します。詳細については、「トピック」を参照してください。

TopicFormatstringいいえ。TopicType が filepath または custom に設定されている場合に必須。//var/log/(.*).logトピックフォーマット。
EnableTimestampNanosecondboolNofalsefalse時間スタンプのナノ秒精度を有効にするかどうかを指定します。
PipelineMetaTagKeyobjectNoEmpty{"HOST_NAME":"__hostname__"}
重要 LoongCollector 3.0.10 以降でのみサポートされます。
LoongCollector メタデータに関連するタグを制御します。キーはタグパラメーター名で、値はログ内のタグのフィールド名です。値が default の場合、デフォルト値が使用されます。値が空の文字列の場合、タグは削除されます。構成可能なタグは以下のとおりです。
  • HOST_NAME: ホスト名。デフォルトで追加されます。デフォルト値: "__hostname__"。

  • AGENT_TAG: カスタム識別子。デフォルトで追加されます。デフォルト値: "__user_defined_id__"。

  • HOST_ID: ホスト ID。デフォルトでは追加されません。デフォルト値: "__host_id__"。

  • CLOUD_PROVIDER: デフォルトでは追加されません。デフォルト値: "__cloud_provider__"。

入力プラグイン。

ファイル入力プラグイン

パラメータータイプ必須デフォルト値例説明
TypestringYes/input_fileプラグインタイプ。値を input_file に設定します。
FilePaths[string]Yes/["/var/log/*.log"]収集するログファイルパスのリスト (1 つのパスのみサポート)。パスでは * および ** ワイルドカードがサポートされています。** ワイルドカードは 1 回のみ使用でき、ファイル名の前にのみ使用できます。
MaxDirSearchDepthuintNo00ファイルパス内の ** ワイルドカードに一致するディレクトリ深度の最大値。このパラメーターは、ログパスに ** ワイルドカードが含まれている場合にのみ効果があります。有効な値: 0 ~ 1000。
ExcludeFilePaths[string]NoEmpty["/home/admin/*.log"]ファイルパスのブロックリスト。パスは絶対パスである必要があります。* ワイルドカードがサポートされています。
ExcludeFiles[string]NoEmpty["app*.log", "password"]ファイル名のブロックリスト。* ワイルドカードがサポートされています。
ExcludeDirs[string]NoEmpty["/home/admin/dir1", "/home/admin/dir2*"]ディレクトリのブロックリスト。パスは絶対パスである必要があります。* ワイルドカードがサポートされています。
FileEncodingstringNoutf8utf8ファイルエンコーディングフォーマット。有効な値: utf8、gbk。
TailSizeKBuintNo10241024構成が初めて効果を発揮する時間に収集が開始されるファイルの末尾からのサイズ。ファイルサイズがこの値より小さい場合、収集は先頭から開始されます。有効な値: 0 ~ 10485760 KB。
MultilineobjectNoEmpty/複数行集約オプション。
Multiline.ModestringNocustomcustom複数行集約モード。有効な値: custom、JSON。
Multiline.StartPatternstringMultiline.Mode が custom に設定されている場合に必須Empty\d+-\d+-\d+.*行頭の正規表現。
EnableContainerDiscoveryboolNofalsetrueコンテナー検出を有効にするかどうかを指定します。このパラメーターは、Logtail が DaemonSet モードで実行されており、収集するファイルパスがコンテナー内のパスである場合にのみ効果があります。
ContainerFiltersobjectNoEmpty/コンテナーフィルターオプション。複数のオプションは AND 関係にあります。このパラメーターは、EnableContainerDiscovery が true に設定されている場合にのみ効果があります。
ContainerFilters.K8sNamespaceRegexstringNoEmptydefaultKubernetes 環境にデプロイされたコンテナーの場合、対象コンテナーが属するポッドの名前空間条件を指定します。このパラメーターが指定されていない場合、すべてのコンテナーが収集されます。正規表現マッチングがサポートされています。
ContainerFilters.K8sPodRegexstringNoEmptytest-podKubernetes 環境にデプロイされたコンテナーの場合、対象コンテナーのポッド名条件を指定します。このパラメーターが指定されていない場合、すべてのコンテナーが収集されます。正規表現マッチングがサポートされています。
ContainerFilters.IncludeK8sLabelmapNoEmpty/Kubernetes 環境にデプロイされたコンテナーの場合、対象コンテナーのポッドラベル条件を指定します。複数の条件は OR 関係にあります。このパラメーターが指定されていない場合、すべてのコンテナーが収集されます。正規表現マッチングがサポートされています。マップのキーはポッドラベル名で、値はポッドラベル値です。
  • マップの値が空の場合、指定されたキーを含むラベルを持つすべてのポッドがマッチします。

  • マップの値が空でない場合:
    • 値が ^ で始まり $ で終わる場合、指定されたキーを含むラベルを持ち、対応するラベル値が正規表現として値にマッチするポッドがマッチします。

    • それ以外の場合、指定されたキーと完全に一致する指定された値を持つラベルを含むポッドがマッチします。

ContainerFilters.ExcludeK8sLabelmapNoEmpty/Kubernetes 環境にデプロイされたコンテナーの場合、収集から除外するコンテナーのポッドラベル条件を指定します。複数の条件は OR 関係にあります。このパラメーターが指定されていない場合、すべてのコンテナーが収集されます。正規表現マッチングがサポートされています。マップのキーはポッドラベル名で、値はポッドラベル値です。
  • マップの値が空の場合、指定されたキーを含むラベルを持つすべてのポッドがマッチします。

  • マップの値が空でない場合:
    • 値が ^ で始まり $ で終わる場合、指定されたキーを含むラベルを持ち、対応するラベル値が正規表現として値にマッチするポッドがマッチします。

    • それ以外の場合、指定されたキーと完全に一致する指定された値を持つラベルを含むポッドがマッチします。

ContainerFilters.K8sContainerRegexstringNoEmptytest-containerKubernetes 環境にデプロイされたコンテナーの場合、コンテナー名条件を指定します。このパラメーターが指定されていない場合、すべてのコンテナーが収集されます。正規表現マッチングがサポートされています。
ContainerFilters.IncludeEnvmapNoEmpty/対象コンテナーの環境変数条件を指定します。複数の条件は OR 関係にあります。このパラメーターが指定されていない場合、すべてのコンテナーが収集されます。正規表現マッチングがサポートされています。マップのキーは環境変数名で、値は環境変数値です。
  • マップの値が空の場合、指定されたキーを含む環境変数を持つすべてのコンテナーがマッチします。

  • マップの値が空でない場合:
    • 値が ^ で始まり $ で終わる場合、指定されたキーを含む環境変数を持ち、対応する値が正規表現として値にマッチするコンテナーがマッチします。

    • それ以外の場合、指定されたキーと完全に一致する指定された値を持つ環境変数を含むコンテナーがマッチします。

ContainerFilters.ExcludeEnvmapNoEmpty/収集から除外するコンテナーの環境変数条件を指定します。複数の条件は OR 関係にあります。このパラメーターが指定されていない場合、すべてのコンテナーが収集されます。正規表現マッチングがサポートされています。マップのキーは環境変数名で、値は環境変数値です。
  • マップの値が空の場合、指定されたキーを含む環境変数を持つすべてのコンテナーがマッチします。

  • マップの値が空でない場合:
    • 値が ^ で始まり $ で終わる場合、指定されたキーを含む環境変数を持ち、対応する値が正規表現として値にマッチするコンテナーがマッチします。

    • それ以外の場合、指定されたキーと完全に一致する指定された値を持つ環境変数を含むコンテナーがマッチします。

ContainerFilters.IncludeContainerLabelmapNoEmpty/対象コンテナーのコンテナーラベル条件を指定します。複数の条件は OR 関係にあります。このパラメーターが指定されていない場合、デフォルト値は空で、すべてのコンテナーが収集されることを示します。正規表現マッチングがサポートされています。マップのキーはコンテナーラベル名で、値はコンテナーラベル値です。
  • マップの値が空の場合、指定されたキーを含むラベルを持つすべてのコンテナーがマッチします。

  • マップの値が空でない場合:
    • 値が ^ で始まり $ で終わる場合、指定されたキーを含むラベルを持ち、対応するラベル値が正規表現として値にマッチするコンテナーがマッチします。

    • それ以外の場合、指定されたキーと完全に一致する指定された値を持つラベルを含むコンテナーがマッチします。

ContainerFilters.ExcludeContainerLabelmapNoEmpty/収集から除外するコンテナーのコンテナーラベル条件を指定します。複数の条件は OR 関係にあります。このパラメーターが指定されていない場合、デフォルト値は空で、すべてのコンテナーが収集されることを示します。正規表現マッチングがサポートされています。マップのキーはコンテナーラベル名で、値はコンテナーラベル値です。
  • マップの値が空の場合、指定されたキーを含むラベルを持つすべてのコンテナーがマッチします。

  • マップの値が空でない場合:
    • 値が ^ で始まり $ で終わる場合、指定されたキーを含むラベルを持ち、対応するラベル値が正規表現として値にマッチするコンテナーがマッチします。

    • それ以外の場合、指定されたキーと完全に一致する指定された値を持つラベルを含むコンテナーがマッチします。

ExternalK8sLabelTagmapNoEmpty/Kubernetes 環境にデプロイされたコンテナーの場合、ログに追加するポッドラベルに関連する追加のタグを指定します。マップのキーはポッドラベル名で、値は対応するタグ名です。たとえば、マップに app: k8s\_label\_app を追加し、ポッドに app=serviceA というラベルが含まれている場合、この情報はタグとしてログに追加されます。つまり、__tag__:k8s_label_app: serviceA というフィールドが追加されます。ポッドに app ラベルが含まれていない場合、空のフィールド __tag__:k8s_label_app: が追加されます。
ExternalEnvTagmapNoEmpty/Kubernetes 環境にデプロイされたコンテナーの場合、ログに追加するコンテナー環境変数に関連する追加のタグを指定します。マップのキーは環境変数名で、値は対応するタグ名です。たとえば、マップに VERSION: env\_version を追加し、コンテナーに VERSION=v1.0.0 という環境変数が含まれている場合、この情報はタグとしてログに追加されます。つまり、__tag__:env_version: v1.0.0 というフィールドが追加されます。コンテナーに VERSION 環境変数が含まれていない場合、空のフィールド __tag__:env_version: が追加されます。
CollectingContainersMetaboolNofalsetrueコンテナーメタデータのプレビューを有効にするかどうかを指定します。
AppendingLogPositionMetaboolNofalsefalseログエントリが属するファイルに関するメタデータ (__tag__:__inode__ フィールドおよび __file_offset__ フィールドを含む) を追加するかどうかを指定します。
AllowingIncludedByMultiConfigsboolNofalsefalse現在の構成で、すでに他の構成にマッチしているファイルを収集することを許可するかどうかを指定します。
TagsobjectNoEmpty{"FileInodeTagKey":"__inode__"}
重要 LoongCollector 3.0.10 以降でのみサポートされます。
ファイル収集に関連するタグを制御します。キーはタグパラメーター名で、値はログ内のタグのフィールド名です。値が default の場合、デフォルト値が使用されます。値が空の文字列の場合、タグは削除されます。構成可能なタグは以下のとおりです。
  • FileInodeTagKey: ファイル inode。デフォルトでは追加されません。デフォルト値: "__inode__"。

  • FilePathTagKey: ファイルパス。デフォルトで追加されます。デフォルト値: "__path__"。

以下のパラメーターは、EnableContainerDiscovery が true に設定されている場合にのみ効果があります。
  • K8sNamespaceTagKey: ファイルが存在するコンテナーの名前空間。デフォルトで追加されます。デフォルト値: "_namespace_"。

  • K8sPodNameTagKey: ファイルが存在するポッド名。デフォルトで追加されます。デフォルト値: "_pod_name_"。

  • K8sPodUidTagKey: ファイルが存在するポッド UID。デフォルトで追加されます。デフォルト値: "_pod_uid_"。

  • ContainerNameTagKey: ファイルが存在するコンテナー名。デフォルトで追加されます。デフォルト値: "_container_name_"。

  • ContainerIpTagKey: ファイルが存在するコンテナー IP。デフォルトで追加されます。デフォルト値: "_container_ip_"。

  • ContainerImageNameTagKey: ファイルが存在するコンテナーイメージ。デフォルトで追加されます。デフォルト値: "_image_name_"。

FileOffsetKeystringNoEmpty__file_offset__
重要 LoongCollector 3.0.10 以降でのみサポートされます。
ファイル内のログ位置のタグ。デフォルトでは追加されません。デフォルト値: __file_offset__。値が __default__ の場合、デフォルト値が使用されます。値が空の文字列の場合、タグは削除されます。EnableLogPositionMeta パラメーターと Tags.FileInodeTagKey または FileOffsetKey パラメーターの両方が指定されている場合、EnableLogPositionMeta パラメーターは無視されます。

コンテナー標準出力 (レガシー)

パラメータータイプ必須デフォルト値例説明
TypestringYes/service_docker_stdoutプラグインタイプ。値を service_docker_stdout に設定します。
StdoutBooleanNotruetrue標準出力 (stdout) を収集するかどうかを指定します。
StderrBooleanNotruetrue標準エラー出力 (stderr) を収集するかどうかを指定します。
StartLogMaxOffsetIntegerNo128×1024131072最初の収集時に遡る履歴データの長さ (バイト単位)。[131072, 1048576] の範囲の値を推奨します。
IncludeLabelMap, where LabelKey and LabelValue are of the String typeNoEmpty

収集するコンテナーを指定するコンテナーラベルの許可リスト。デフォルト値は空で、すべてのコンテナーの stdout が収集されることを示します。コンテナーラベル許可リストを構成するには、LabelKey が必須で、LabelValue は任意です。

  • LabelValue が空の場合、指定された LabelKey を含むラベルを持つすべてのコンテナーがマッチします。

  • LabelValue が空でない場合、LabelKey=LabelValue を含むラベルを持つコンテナーのみがマッチします。

    LabelValue はデフォルトで完全一致文字列マッチングを使用します。つまり、コンテナーラベル値は LabelValue と同一である必要があります。値が ^ で始まり $ で終わる場合、正規表現マッチングが使用されます。たとえば、LabelKey を io.kubernetes.container.name に、LabelValue を ^(nginx|cube)$ に設定すると、nginx または cube という名前のコンテナーがマッチします。

複数の許可リストエントリは OR 関係にあります。コンテナーのラベルがいずれかの許可リストエントリを満たす場合、そのコンテナーはマッチします。

ExcludeLabelMap, where LabelKey and LabelValue are of the String typeNoEmpty

収集から除外するコンテナーを指定するコンテナーラベルのブロックリスト。デフォルト値は空で、コンテナーが除外されないことを示します。コンテナーラベルブロックリストを構成するには、LabelKey が必須で、LabelValue は任意です。

  • LabelValue が空の場合、指定された LabelKey を含むラベルを持つすべてのコンテナーが除外されます。

  • LabelValue が空でない場合、LabelKey=LabelValue を含むラベルを持つコンテナーのみが除外されます。

    LabelValue はデフォルトで完全一致文字列マッチングを使用します。つまり、コンテナーラベル値は LabelValue と同一である必要があります。値が ^ で始まり $ で終わる場合、正規表現マッチングが使用されます。たとえば、LabelKey を io.kubernetes.container.name に、LabelValue を ^(nginx|cube)$ に設定すると、nginx または cube という名前のコンテナーがマッチします。

複数のブロックリストエントリは OR 関係にあります。コンテナーのラベルがいずれかのブロックリストエントリを満たす場合、そのコンテナーは除外されます。

IncludeEnvMap, where EnvKey and EnvValue are of the String typeNoEmpty

収集するコンテナーを指定する環境変数の許可リスト。デフォルト値は空で、すべてのコンテナーの stdout が収集されることを示します。環境変数許可リストを構成するには、EnvKey が必須で、EnvValue は任意です。

  • EnvValue が空の場合、指定された EnvKey を含む環境変数を持つすべてのコンテナーがマッチします。

  • EnvValue が空でない場合、EnvKey=EnvValue を含む環境変数を持つコンテナーのみがマッチします。

    EnvValue はデフォルトで完全一致文字列マッチングを使用します。つまり、環境変数値は EnvValue と同一である必要があります。値が ^ で始まり $ で終わる場合、正規表現マッチングが使用されます。たとえば、EnvKey を NGINX_SERVICE_PORT に、EnvValue を `^(80

ExcludeEnvMap, where EnvKey and EnvValue are of the String typeNoEmpty

収集から除外するコンテナーを指定する環境変数のブロックリスト。デフォルト値は空で、コンテナーが除外されないことを示します。環境変数ブロックリストを構成するには、EnvKey が必須で、EnvValue は任意です。

  • EnvValue が空の場合、指定された EnvKey を含む環境変数を持つすべてのコンテナーのログが除外されます。

  • EnvValue が空でない場合、EnvKey=EnvValue を含む環境変数を持つコンテナーのみが除外されます。

    EnvValue はデフォルトで完全一致文字列マッチングを使用します。つまり、環境変数値は EnvValue と同一である必要があります。値が ^ で始まり $ で終わる場合、正規表現マッチングが使用されます。たとえば、EnvKey を NGINX_SERVICE_PORT に、EnvValue を ^(80|6379)$ に設定すると、サービスポートが 80 または 6379 のコンテナーがマッチします。

複数のブロックリストエントリは OR 関係にあります。コンテナーの環境変数がいずれかのキーと値のペアを満たす場合、そのコンテナーは除外されます。

IncludeK8sLabelMap, where LabelKey and LabelValue are of the String typeNoEmpty

Kubernetes Label (template.metadata で定義) の許可リストを使用して収集するコンテナーを指定します。Kubernetes Label 許可リストを構成するには、LabelKey が必須で、LabelValue は任意です。

  • LabelValue が空の場合、指定された LabelKey を含む Kubernetes Label を持つすべてのコンテナーがマッチします。

  • LabelValue が空でない場合、LabelKey=LabelValue を含む Kubernetes Label を持つコンテナーのみがマッチします。

    LabelValue はデフォルトで完全一致文字列マッチングを使用します。つまり、Kubernetes Label 値は LabelValue と同一である必要があります。値が ^ で始まり $ で終わる場合、正規表現マッチングが使用されます。たとえば、LabelKey を app に、LabelValue を ^(test1|test2)$ に設定すると、app:test1 または app:test2 を含む Kubernetes Label を持つコンテナーがマッチします。

複数の許可リストエントリは OR 関係にあります。コンテナーの Kubernetes Label いずれかの許可リストエントリを満たす場合、そのコンテナーはマッチします。

ExcludeK8sLabelMap, where LabelKey and LabelValue are of the String typeNoEmpty

Kubernetes Label (template.metadata で定義) のブロックリストを使用して収集から除外するコンテナーを指定します。Kubernetes Label ブロックリストを構成するには、LabelKey が必須で、LabelValue は任意です。

  • LabelValue が空の場合、指定された LabelKey を含む Kubernetes Label を持つすべてのコンテナーが除外されます。

  • LabelValue が空でない場合、LabelKey=LabelValue を含む Kubernetes Label を持つコンテナーのみが除外されます。

    LabelValue はデフォルトで完全一致文字列マッチングを使用します。つまり、Kubernetes Label 値は LabelValue と同一である必要があります。値が ^ で始まり $ で終わる場合、正規表現マッチングが使用されます。たとえば、LabelKey を app に、LabelValue を ^(test1|test2)$ に設定すると、app:test1 または app:test2 を含む Kubernetes Label を持つコンテナーがマッチします。

複数のブロックリストエントリは OR 関係にあります。コンテナーの Kubernetes Label いずれかのブロックリストエントリを満たす場合、そのコンテナーは除外されます。

K8sNamespaceRegexStringNoEmpty^(default|nginx)$名前空間名で収集するコンテナーを指定します。正規表現マッチングがサポートされています。たとえば、このパラメーターを ^(default|nginx)$ に設定すると、nginx および default 名前空間内のすべてのコンテナーがマッチします。
K8sPodRegexStringNoEmpty^(nginx-log-demo.*)$ポッド名で収集するコンテナーを指定します。正規表現マッチングがサポートされています。たとえば、このパラメーターを ^(nginx-log-demo.*)$ に設定すると、名前が nginx-log-demo で始まるポッド内のすべてのコンテナーがマッチします。
K8sContainerRegexStringNoEmpty^(container-test)$コンテナー名 (Kubernetes コンテナー名は spec.containers で定義) で収集するコンテナーを指定します。正規表現マッチングがサポートされています。たとえば、このパラメーターを ^(container-test)$ に設定すると、container-test という名前のすべてのコンテナーがマッチします。

データ処理パラメーター

パラメータータイプ必須デフォルト値例説明
BeginLineRegexStringNoEmpty

行頭のマッチに使用される正規表現フォーマット。

このパラメーターが空の場合、単一行モードが使用されます。

式が行頭にマッチする場合、その行は新しいログエントリとして扱われます。それ以外の場合、その行は前のログエントリに追加されます。

BeginLineCheckLengthIntegerNoEmpty

行頭のマッチングの長さ。単位: バイト。

デフォルト値: 10 × 1024 バイト。

行頭のマッチングの正規表現が最初の N バイト以内で確定できる場合、マッチング効率を向上させるためにこのパラメーターを設定します。

BeginLineTimeoutMsIntegerNoEmpty

行頭のマッチングのタイムアウト時間。単位: ミリ秒。

デフォルト値: 3000 ミリ秒。

3000 ミリ秒以内に新しいログエントリが表示されない場合、マッチングは終了し、最後のログエントリが Simple Log Service にアップロードされます。

MaxLogSizeIntegerNoEmpty

ログエントリの長さの最大値。デフォルト値: 0。単位: バイト。

デフォルト値: 512 × 1024 バイト。

ログエントリの長さがこの値を超えると、システムは次の行頭の検索を停止し、ログエントリを直接アップロードします。

ExternalK8sLabelTagMap (LabelKey および LabelValue は String 型)NoEmpty

Kubernetes Label タグ (template.metadata で定義) を構成した後、iLogtail は Kubernetes Label 関連のフィールドをログに追加します。

たとえば、LabelKey を app に、LabelValue を k8s_label_app に設定し、ポッドに app=serviceA というラベルが含まれている場合、iLogtail は k8s_label_app: serviceA というフィールドをログに追加します。ポッドに app という名前のラベルが含まれていない場合、空のフィールド k8s_label_app: が追加されます。

ExternalEnvTagMap (EnvKey および EnvValue は String 型)NoEmpty

コンテナー環境変数タグを構成した後、iLogtail はコンテナー環境変数関連のフィールドをログに追加します。

たとえば、EnvKey を VERSION に、EnvValue を env_version に設定し、コンテナーに VERSION=v1.0.0 という環境変数が含まれている場合、情報はタグとしてログに追加されます。つまり、env_version: v1.0.0 というフィールドが追加されます。コンテナーに VERSION という名前の環境変数が含まれていない場合、空のフィールド env_version: が

レスポンスフィールド

フィールド

型

説明

例

レスポンスフィールドがありません。

例

成功レスポンス

JSONJSON

{}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。