Elastic Container Instance:SLS CRD を使用したログの収集

背景情報

Alibaba Cloud の Simple Log Service (SLS) は、ログデータのためのオールインワンサービスです。開発不要で、ログデータの収集、消費、配信、クエリ、分析が可能です。詳細については、「Simple Log Service とは」をご参照ください。

前提条件

Simple Log Service が有効化されていることを確認してください。Simple Log Service コンソールにログインしたときにサービスが有効化されていない場合は、プロンプトが表示されます。画面の指示に従ってサービスを有効化できます。

注意事項

SLS CRD によって有効化されたログ収集は、CRD の構成後に作成された Elastic Container Instance (ECI) Pod にのみ適用されます。既存の Pod からログを収集するには、ローリングデプロイを実行する必要があります。

ログ収集の構成

クラスターに alibaba-log-controller コンポーネントをデプロイした後、AliyunLogConfig CRD を使用してログ収集を構成できます。

ログ収集のテスト

AliyunLogConfig CRD を作成すると、SLS はその後に作成された Pod から自動的にログを収集します。次のアプリケーションを作成して、このログ収集機能をテストできます。

1. アプリケーションを作成します。

   次の YAML ファイルは、Deployment を作成する方法の例です。この例では、コンテナが起動した後、標準出力とログファイルを継続的に出力するコマンドを実行します。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: eci-sls-demo
     labels:
       app: sls
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: sls
     template:
       metadata:
         name: sls-test
         labels:
           app: sls
           alibabacloud.com/eci: "true" 
       spec:
         containers:
         - args:
           - -c
           - mkdir -p /log;while true; do echo hello world; date; echo hello sls >> /log/busy.log; sleep 1;done
           command:
           - /bin/sh
           image: registry-vpc.cn-beijing.aliyuncs.com/eci_open/busybox:1.30
           imagePullPolicy: Always
           name: busybox

   上記 YAML の内容を test-sls-crd.yaml として保存し、次のコマンドを実行してアプリケーションを作成します。

   kubectl create -f test-sls-crd.yaml

2. アプリケーションのステータスを確認します。

   kubectl get pod

   期待される出力：

   NAME                            READY   STATUS    RESTARTS   AGE
   eci-sls-demo-7bf8849b9f-cgpbn   1/1     Running   0          2m14s

3. ログを表示します。

   1. Simple Log Service コンソールにログインします。

   2. 対象のプロジェクトの名前をクリックします。

   3. 対象の Logstore を見つけて、その名前をクリックしてログを表示します。

      テキストログ

      

      標準出力

      

ログ収集の無効化

AliyunLogConfig CRD を作成すると、システムは指定された条件を満たすすべての Pod から自動的にログを収集します。特定の Pod からのログ収集を防ぐには、Pod のメタデータに k8s.aliyun.com/eci-sls-enable: "false" アノテーションを追加します。この方法により、Logtail 構成の自動作成によるリソースの無駄を防ぐことができます。

次のコードは、サンプル構成を示しています：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: eci-sls-demo2
  labels:
    app: sls
spec:
  replicas: 1
  selector:
    matchLabels:
      app: sls
  template:
    metadata:
      name: sls-test
      labels:
        app: sls
        alibabacloud.com/eci: "true"
      annotations:
        k8s.aliyun.com/eci-sls-enable: "false"    # ログ収集を無効にします。
    spec:
      containers:
      - args:
        - -c
        - mkdir -p /log;while true; do echo hello world; date; echo hello sls >> /log/busy.log; sleep 1;
          done
        command:
        - /bin/sh
        image: registry.cn-shanghai.aliyuncs.com/eci_open/busybox:1.30
        imagePullPolicy: Always
        name: busybox