Fargate 日志记录

将日志发送到您选择的目标

应用ConfigMap添加到您的亚马逊 EKS 集群中Fluent Conf数据值，用于定义容器日志发送到的位置。Fluent Conf是 Fluent Bit，这是一种快速轻量级的日志处理器配置语言，用于将容器日志路由到您选择的日志目标。有关更多信息，请参阅 。配置文件在流利位文档中。

在以下步骤中，将<example values>使用您自己的值。

1. 创建 Kubernetes 命名空间。

   1. 将以下内容保存到计算机上名为 aws-observability-namespace.yaml 的文件中。此名称必须是aws-observability。

      kind: Namespace
      apiVersion: v1
      metadata:
        name: aws-observability
        labels:
          aws-observability: enabled

   2. 创建命名空间。

      kubectl apply -f aws-observability-namespace.yaml

2. 配置 Kubernetes 以将 Fargate 日志发送到以下目标之一。这些区域有：ConfigMap必须在aws-observability命名空间。

   1. （可选）将日志发送到 CloudWatch。使用 CloudWatch 视时，您有两个输出选项：

      • cloudwatch_logs— 用 C 编写的输出插件。

      • cloudwatch— 用 Golang 编写的输出插件。

      以下示例为您展示了如何使用cloudwatch_logs插件将日志发送到 CloudWatch。

      1. 将以下内容保存到名为的文件中aws-logging-cloudwatch-configmap.yaml。

         kind: ConfigMap
         apiVersion: v1
         metadata:
           name: aws-logging
           namespace: aws-observability
           labels:
         data:
           output.conf: |
             [OUTPUT]
                 Name cloudwatch_logs
                 Match   *
                 region <us-east-1>
                 log_group_name fluent-bit-cloudwatch
                 log_stream_prefix from-fluent-bit-
                 auto_create_group true

      2. 将清单应用于集群。

         kubectl apply -f aws-logging-cloudwatch-configmap.yaml

      3. 将 CloudWatch IAM 策略下载到您的计算机。您还可以查看策略（位于 GitHub 上）。

         curl -o permissions.json https://raw.githubusercontent.com/aws-samples/amazon-eks-fluent-logging-examples/mainline/examples/fargate/cloudwatchlogs/permissions.json

   2. （可选）向 Amazon Elasticsearch Service 发送日志。您可以使用es输出，这是用 C 编写的插件。以下示例介绍如何使用插件将日志发送到 Elasticsearch。

      1. 将以下内容保存到名为的文件中aws-logging-elasticsearch-configmap.yaml。

         kind: ConfigMap
         apiVersion: v1
         metadata:
           name: aws-logging
           namespace: aws-observability
           labels:
         data:
           output.conf: |
             [OUTPUT]
               Name  es
               Match *
               Host  192.168.2.3
               Port  9200
               Index my_index
               Type  my_type
               AWS_Auth On
               AWS_Region <us-east-1>

      2. 将清单应用于集群。

         kubectl apply -f aws-logging-elasticsearch-configmap.yaml

      3. 将 Elasticsearch IAM 策略下载到您的计算机。您还可以查看策略（位于 GitHub 上）。

         curl -o permissions.json https://raw.githubusercontent.com/aws-samples/amazon-eks-fluent-logging-examples/mainline/examples/fargate/amazon-elasticsearch/permissions.json

   3. （可选）将日志发送到 Kinesis Data Firehose。使用 Kinesis Data Firehose 时有两个输出选项：

      • kinesis_firehose— 用 C 编写的输出插件。

      • firehose— 用 Golang 编写的输出插件。

      以下示例为您展示了如何使用kinesis_firehose插件将日志发送到 Kinesis Data Firehose。

      1. 将以下内容保存到名为的文件中aws-logging-firehose-configmap.yaml。

         kind: ConfigMap
         apiVersion: v1
         metadata:
           name: aws-logging
           namespace: aws-observability
           labels:
         data:
           output.conf: |
             [OUTPUT]
              Name  kinesis_firehose
              Match *
              region <us-east-1>
              delivery_stream my-stream-firehose

      2. 将清单应用于集群。

         kubectl apply -f aws-logging-firehose-configmap.yaml

      3. 将 Kinesis Data Firehose IAM 策略下载到您的计算机。您还可以查看策略（位于 GitHub 上）。

         curl -o permissions.json https://raw.githubusercontent.com/aws-samples/amazon-eks-fluent-logging-examples/mainline/examples/fargate/kinesis-firehose/permissions.json

3. 创建一个 IAM 策略。

   aws iam create-policy --policy-name <eks-fargate-logging-policy> --policy-document file://permissions.json

4. 将 IAM 策略附加到为 Fargate 配置文件指定的容器执行角色。Replace<111122223333>（使用您的账户 ID）。

   aws iam attach-role-policy \
     --policy-arn arn:aws:iam::<111122223333>:policy/<eks-fargate-logging-policy> \
     --role-name <your-pod-execution-role>

5. 部署示例容器。

   1. 将以下内容保存到yaml文件。

      apiVersion: apps/v1
      kind: Deployment
      metadata:
        name: sample-app
        namespace: <same-namespace-as-your-fargate-profile>
      spec:
        replicas: 3
        selector:
          matchLabels:
            app: nginx
        template:
          metadata:
            labels:
              app: nginx
          spec:
            containers:
              - name: nginx
                image: nginx:latest
                ports:
                  - name: http
                    containerPort: 80

   2. 将清单应用于集群。

      kubectl apply -f <name-of-file-from-previous-step>.yaml

6. 使用您向其发送日志的工具查看日志。