Simple Log Service:AliyunLogConfig を使用した Logtail 構成の管理

Logtail 構成の作成

AliyunLogConfig から CR を作成します。CR を作成すると、alibaba-log-controller が CR に基づいて Logtail 構成を作成し、その構成を自動的に適用します。

1. クラスターの kubeconfig ファイルを取得し、kubectl を使用してクラスターに接続します。

2. 次のコマンドを実行して YAML ファイルを作成します。この例では、ファイル名は cube.yaml です。必要に応じてファイル名を置き換えてください。

   vim cube.yaml

3. YAML ファイルに次のスクリプトを入力し、必要に応じてパラメーターを設定します。このスクリプトには必須フィールドのみが含まれています。inputType を設定してログの収集方法を指定し、inputDetail を設定してログ入力の設定を行います。CR のフィールドの詳細については、「CR パラメータ」をご参照ください。

   apiVersion: log.alibabacloud.com/v1alpha1      # デフォルト値を使用します。このパラメーターを変更する必要はありません。
   kind: AliyunLogConfig                          # デフォルト値を使用します。このパラメーターを変更する必要はありません。
   metadata:
     name: test-config                            # リソースの名前。現在の Kubernetes クラスター内で一意である必要があります。
   spec:
     logstore: k8s-stdout                         # Logstore の名前。指定した Logstore が存在しない場合、SLS は自動的に Logstore を作成します。
     logtailConfig:                               # Logtail 構成。
       inputType: plugin                          # ログの収集元となるデータソースのタイプ。
       configName: test-config                    # Logtail 構成の名前。
       inputDetail:                               # Logtail 構成の詳細。
         ...

4. 次のコマンドを実行して、AliyunLogConfig から CR を作成します。Logtail 構成が有効になると、Logtail はデータの収集を開始し、そのデータを SLS に送信します。

   kubectl apply -f cube.yaml

5. CR の statusCode フィールドの値が 200 であることを確認します。手順については、「Logtail 構成の表示」をご参照ください。

Logtail 構成の表示

現在の Kubernetes クラスター内で AliyunLogConfig によって作成されたすべての Logtail 構成を表示するには、次のコマンドを実行します。

kubectl get aliyunlogconfigs

AliyunLogConfig によって作成された単一の Logtail 構成の詳細とステータスを表示するには、次のコマンドを実行します。<config_name> は AliyunLogConfig の名前です。必要に応じて名前を置き換えてください。

kubectl get aliyunlogconfigs <config_name> -o yaml

次のような結果が返されます。この例では、Logtail 構成は inputType: file を使用しています。

apiVersion: log.alibabacloud.com/v1alpha1
kind: AliyunLogConfig
metadata:
  name: example-k8s-file
  namespace: kube-system
spec:
  project: k8s-log-test
  logstore: k8s-file
  logtailConfig:
    inputType: file
    configName: example-k8s-file
    inputDetail:
      logType: common_reg_log
      logPath: /data/logs/app_1
      filePattern: test.LOG
      dockerFile: true
status:
  status: OK
  statusCode: 200

結果内の status フィールドと statusCode フィールドは、Logtail 構成のステータスを示します。

• statusCode フィールドの値が 200 の場合、Logtail 構成が適用されています。

• statusCode フィールドの値が 200 でない場合、Logtail 構成の適用に失敗しています。status フィールドで報告されたステータスを確認してください。

Logtail 構成の更新

AliyunLogConfig によって作成された Logtail 構成を更新するには、CR の既存の YAML ファイルを変更し、そのファイルを再度適用します。

1. クラスターの kubeconfig ファイルを取得し、kubectl を使用してクラスターに接続します。

2. 既存の AliyunLogConfig YAML ファイル (例: cube.yaml) を編集します。

   vim cube.yaml

3. 必要に応じて YAML ファイル内のパラメーターを変更します。CR のフィールドの詳細については、「CR パラメータ」をご参照ください。

4. 次のコマンドを実行してファイルを適用し、Logtail 構成を有効にします。

   kubectl apply -f cube.yaml

5. CR の statusCode フィールドの値が 200 であることを確認します。手順については、「Logtail 構成の表示」をご参照ください。

Logtail 構成の削除

AliyunLogConfig によって作成された Logtail 構成を削除するには、対応する CR を削除します。次のコマンドの <config_name> は AliyunLogConfig の名前です。必要に応じて名前を置き換えてください。

kubectl delete aliyunlogconfigs <config_name>

削除を確認するには、kubectl get aliyunlogconfigs を実行し、CR がリストに表示されなくなったことを確認します。

apiVersion

値は log.alibabacloud.com/v1alpha1 に固定されています。

kind

値は AliyunLogConfig に固定されています。

metadata

metadata フィールドは、Kubernetes クラスター内で CR を識別します。

spec

spec フィールドは、送信先プロジェクトと Logstore、送信先 Logstore の属性、および Logtail 構成の詳細を指定します。

AliyunLogConfigDetail

パラメーターの詳細については、「Logtail 構成 (レガシー)」をご参照ください。AliyunLogConfigDetail のデータ形式は、「Logtail 構成 (レガシー)」で説明されている形式と同じです。