Container Service for Kubernetes:SLS を使用した nginx-ingress-controller のアクセスログの分析

ACK コンソール

1. ACK コンソールにログオンします。 左側のナビゲーションペインで、ACK コンソールの[クラスター] をクリックします。

2. [クラスター] ページで、対象のクラスターをクリックします。左側メニューで、[運用] > [アドオン] を選択します。

3. [アドオン] ページで、[ネットワーク] タブをクリックします。[Nginx Ingress Controller] カードで、 アイコンをクリックし、[ログ収集の有効化] を選択します。[OK] をクリックします。

CLI

ACK は AliyunLogConfig という名前の CRD を提供します。AliyunLogConfig を作成すると、alibaba-log-controller は自動的に SLS 設定を生成し、ダッシュボードを更新します。

1. k8s-nginx-ingress.yaml という名前でファイルを作成し、次の内容を記述します。

   IncludeLabel に、docker inspect の Docker ラベルを設定します。io.kubernetes.pod.namespace は名前空間で選択し、io.kubernetes.container.name はコンテナで選択します。たとえば、io.kubernetes.pod.namespace: backend-prod はその名前空間のすべてのコンテナを収集し、io.kubernetes.container.name: worker-server は特定のコンテナをターゲットにします。これらの 2 つのラベルのみを指定してください。環境変数でフィルタリングするには、IncludeEnv または ExcludeEnv を使用します。詳細については、「DaemonSet モードで Simple Log Service コンソールを使用してコンテナの stdout と stderr を収集する」をご参照ください。

   フィールド	説明	変更が必要か
   metadata.namespace	Ingress コントローラーの namespace	はい、kube-system でない場合
   spec.logstore	SLS Logstore 名	任意
   IncludeLabel	コンテナーの選択に使用される Docker ラベル	特定の namespace から収集する場合
   processor_regex > Regex	ログ解析用の正規表現	デフォルトのログ形式を変更した場合のみ

   apiVersion: log.alibabacloud.com/v1alpha1
   kind: AliyunLogConfig
   metadata:
     # この AliyunLogConfig のクラスター内での一意の名前。
     name: k8s-nginx-ingress
     # ログを収集する Ingress コントローラーの namespace に設定します。
     namespace: kube-system
   spec:
     # ログが保存される SLS Logstore。
     logstore: nginx-ingress
     # プロダクトコード — この値は変更しないでください。
     productCode: k8s-nginx-ingress
     logtailConfig:
       inputType: plugin
       # metadata.name と一致させる必要があります。
       configName: k8s-nginx-ingress
       inputDetail:
         plugin:
           inputs:
             - type: service_docker_stdout
               detail:
                 IncludeLabel:
                   # nginx-ingress-controller コンテナーからログを収集します。
                   # クラスター内で複数の Ingress コントローラーが実行されている場合、コンテナー名で収集するとログが重複する可能性があります。
                   # 適用する前に IncludeLabel の動作を確認してください。
                   io.kubernetes.container.name: nginx-ingress-controller
                 Stderr: true
                 Stdout: true
           processors:
             - type: processor_regex
               detail:
                 KeepSource: false
                 # 各ログ行から抽出されるフィールド (順番通り)：
                 Keys:
                   - client_ip
                   - x_forward_for
                   - remote_user
                   - time
                   - method
                   - url
                   - version
                   - status
                   - body_bytes_sent
                   - http_referer
                   - http_user_agent
                   - request_length
                   - request_time
                   - proxy_upstream_name
                   - upstream_addr
                   - upstream_response_length
                   - upstream_response_time
                   - upstream_status
                   - req_id
                   - host
                   - proxy_alternative_upstream_name
                 NoKeyError: true
                 NoMatchError: true
                 # 各キャプチャグループを上記のキーにマッピングする正規表現。
                 Regex: ^(\S+)\s-\s\[([^]]+)]\s-\s(\S+)\s\[(\S+)\s\S+\s"(\w+)\s(\S+)\s([^"]+)"\s(\d+)\s(\d+)\s"([^"]*)"\s"([^"]*)"\s(\S+)\s(\S+)+\s\[([^]]*)]\s(\S+?(?:,\s\S+?)*)\s(\S+?(?:,\s\S+?)*)\s(\S+?(?:,\s\S+?)*)\s(\S+?(?:,\s\S+?)*)\s(\S+)\s*(\S*)\s*\[*([^]]*)\]*.*
                 SourceKey: content

   上記の表では、カスタマイズする可能性が最も高いフィールドについて説明しています。

2. 設定を適用します。

   kubectl apply -f k8s-nginx-ingress.yaml

ログ収集を無効にするには、AliyunLogConfig を削除します：

kubectl delete aliyunlogconfig k8s-nginx-ingress -n kube-system