Container Service for Kubernetes:Simple Log Service CRDを使用したアプリケーションログの収集

AliyunLogConfig CRD YAML template
apiVersion: log.alibabacloud.com/v1alpha1      # The default value is used. You do not need to modify this parameter. 
kind: AliyunLogConfig                          # The default value is used. You do not need to modify this parameter. 
metadata:
  name: simple-stdout-example                  # The name of the resource. The name must be unique in the current Kubernetes cluster. 
spec:
  project: k8s-my-project                      # Optional. The name of the project. The default value is the name of the project that you use to install the Logtail components. 
  logstore: k8s-stdout                         # The name of the Logstore. If the specified Logstore does not exist, Simple Log Service automatically creates a Logstore. 
  logstoreMode: standard                       # Optional. The type of the Logstore. The value of this parameter takes effect only if you configure the parameter when you create the Logstore. 
  shardCount: 2                                # Optional. The number of shards. Valid values: 1 to 10. Default value: 2. 
  lifeCycle: 90                                # The data retention period of the Logstore. The value of this parameter takes effect only if you configure the parameter when you create the Logstore. Valid values: 1 to 3650. Default value: 90. Unit: days. The value 3650 specifies that data is permanently stored in the Logstore. 
  logtailConfig:                               # The Logtail configuration. 
    inputType: plugin                          # The type of the data source. Valid values: file and plugin. The value file specifies text logs. The value plugin specifies stdout. 
    configName: simple-stdout-example          # The name of the Logtail configuration. The name must be the same as the resource name that is specified in metadata.name. 
    inputDetail:                               # The detailed settings of the Logtail configuration. For more information, see the following configuration examples. 
      ...

• 基本パラメータ

  パラメーター	タイプ	必須	説明
  project	String	選択可能	プロジェクトの名前。 デフォルト値は、Logtailコンポーネントのインストールに使用するプロジェクトの名前です。
  logstore	String	必須	ログストアの名前 指定されたLogstoreが存在しない場合、Simple Log Serviceは自動的にLogstoreを作成します。
  logstoreMode	String	選択可能	Logstoreのタイプ。 このパラメーターは、Logstoreを作成した場合にのみ有効になります。 有効な値： query: Logstoreを照会します。 standard: 標準Logstore。 詳細については、「Logstore の管理」をご参照ください。
  shardCount	int	選択可能	シャードの数。 有効な値: 1 ~ 10。 デフォルト値：2
  lifeCycle	int	選択可能	Logstoreのデータ保持期間。 有効な値: 1 ~ 3650 デフォルト値: 90。 単位：日 値3650は、データがLogstoreに永続的に格納されることを指定します。 このパラメーターは、Logstoreを作成した場合にのみ有効になります。
  machineGroups	array	選択可能	マシングループ。 Logtailコンポーネントをインストールすると、Simple Log Serviceはk8s-group-${your_k8s_cluster_id} という名前のマシングループを自動的に作成します。
  logtailConfig	object	必須	Logtail設定。 設定には以下のパラメータが含まれます。 configName: Logtail設定の名前。 inputType: ログ入力のタイプ。 有効な値： plugin: Logtailプラグインを使用してMySQLバイナリログなどのログを収集します。 file: 正規表現モードや区切り文字モードなどの固定モードでテキストログを収集します。 inputDetail: ログ入力の設定。 outputType: ログ出力のタイプ。 値をLogServiceに設定します。 ログはSimple Log Serviceにのみアップロードできます。 outputDetail: ログ出力の設定。 logSample: サンプルログ。 パラメーター設定の詳細については、「Logtail設定」をご参照ください。

• コンテナフィルタリング.

  • v1.0.34より前のLogtailを使用する場合は、環境変数とコンテナラベルを使用してのみコンテナをフィルタリングできます。

    Kubernetesクラスターの名前空間とKubernetesクラスター内のコンテナーの名前は、コンテナーラベルにマップできます。 名前空間のLabel Nameパラメーターの値はio.kubernetes.pod.nameスペースです。 コンテナー名のLabel Nameパラメーターの値がio.kubernetes.container.nameです。 2つのコンテナラベルを使用してコンテナをフィルタリングすることを推奨します。 コンテナラベルがビジネス要件を満たしていない場合は、環境変数ホワイトリストまたは環境変数ブラックリストを使用してコンテナをフィルタリングできます。

  • Logtail 1.0.34以降のバージョンを使用する場合、ポッド名、名前空間、コンテナ名、コンテナラベルなどのKubernetesレベルの情報に基づいてコンテナをフィルタリングできます。

    コンテナフィルタリングパラメータは、logtailConfig.inputDetail.advanced.k8sフィールドで設定する必要があります。 サポートされるパラメータ:

    • IncludeK8sLabel: データを収集するコンテナーを指定するKubernetesラベルホワイトリスト。

    • ExcludeK8sLabel: データを収集しないコンテナーを指定するKubernetesラベルブラックリスト。

    • K8sNamespaceRegex: 名前空間。

    • K8sPodRegex: ポッドの名前。

    • K8sContainerRegex: コンテナ名。

詳細については、「DaemonSetモードでKubernetesコンテナからテキストログを収集する」および「Simple Log Serviceコンソールを使用してDaemonSetモードでコンテナのstdoutとstderrを収集する」をご参照ください。