Configuración del agente de CloudWatch para recopilar las métricas del clúster

Para crear un espacio de nombres para CloudWatch

• Escriba el siguiente comando.

  kubectl apply -f https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/k8s-deployment-manifest-templates/deployment-mode/daemonset/container-insights-monitoring/cloudwatch-namespace.yaml

Para utilizar kubectl con el fin de crear una cuenta de servicio para el agente de CloudWatch

• Escriba el siguiente comando.

  kubectl apply -f https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/k8s-deployment-manifest-templates/deployment-mode/daemonset/container-insights-monitoring/cwagent/cwagent-serviceaccount.yaml

Para crear un ConfigMap para el agente de CloudWatch

1. Descargue el archivo YAML de ConfigMap en el host de cliente de kubectl ejecutando el siguiente comando:

   curl -O https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/k8s-deployment-manifest-templates/deployment-mode/daemonset/container-insights-monitoring/cwagent/cwagent-configmap-enhanced.yaml

2. Edite el archivo YAML que ha descargado, tal y como se indica a continuación:

   • cluster_name: en la sección kubernetes, reemplace {{cluster_name}} con el nombre del clúster. Elimine los caracteres {{}}. De forma alternativa, si utiliza un clúster de Amazon EKS, puede eliminar el campo "cluster_name" y el valor. Si lo hace, el agente de CloudWatch detecta el nombre del clúster a partir de las etiquetas de Amazon EC2.

3. (Opcional) Realice más cambios en ConfigMap en función de sus requisitos de supervisión, tal y como se indica a continuación:

   • metrics_collection_interval: en la sección kubernetes, puede especificar la frecuencia con la que el agente recopila las métricas. El valor predeterminado es de 60 segundos. El valor predeterminado del intervalo de recopilación de cadvisor en kubelet es de 15 segundos, por lo que no debe establecer este valor en menos de 15 segundos.

   • endpoint_override: en la sección logs, puede especificar el punto de enlace de CloudWatch Logs si desea anular el punto de enlace predeterminado. Es posible que desee hacerlo si realiza la publicación desde un clúster de una VPC y desea que los datos vayan a un punto de enlace de la VPC.

   • force_flush_interval: en la sección logs, puede especificar el intervalo para los eventos de registro por lotes antes de que se publiquen en CloudWatch Logs. El valor predeterminado es de 5 segundos.

   • Región: de forma predeterminada, el agente publica las métricas en la Región donde se encuentra el nodo de trabajo. Para cambiar este comportamiento, puede agregar un campo region en la sección agent: por ejemplo "region":"us-west-2"

   • Sección statsd: si desea que el agente CloudWatch Logs se ejecute también como agente de escucha StatsD en cada nodo de trabajo de su clúster, puede agregar una la secciónstatsd a las metrics, como en el ejemplo siguiente. Para obtener información sobre otras opciones de StatsD para esta sección, consulte Recuperación de las métricas personalizadas con StatsD.

     "metrics": {
       "metrics_collected": {
         "statsd": {
           "service_address":":8125"
         }
       }
     }

     A continuación, se muestra un ejemplo completo de la sección JSON. Si utiliza un archivo kubeconfig para la autenticación, agregue el parámetro kube_config_path para especificar la ruta del archivo kubeconfig.

     {
         "agent": {
             "region": "us-east-1"
         },
         "logs": {
             "metrics_collected": {
                 "kubernetes": {
                     "cluster_name": "MyCluster",
                     "metrics_collection_interval": 60,
                     "kube_config_path": "/path/to/your/kubeconfig" //if using kubeconfig for authentication
                 }
             },
             "force_flush_interval": 5,
             "endpoint_override": "logs.us-east-1.amazonaws.com"
         },
         "metrics": {
             "metrics_collected": {
                 "statsd": {
                     "service_address": ":8125"
                 }
             }
         }
     }

4. Cree el ConfigMap en el clúster ejecutando el siguiente comando.

   kubectl apply -f cwagent-configmap.yaml

Para implementar el agente de CloudWatch como un DaemonSet

1. • Si no desea utilizar StatsD en el clúster, escriba el siguiente comando.

     kubectl apply -f https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/k8s-deployment-manifest-templates/deployment-mode/daemonset/container-insights-monitoring/cwagent/cwagent-daemonset.yaml

   • Si desea utilizar StatsD, siga estos pasos:

     1. Descargue el archivo YAML del DaemonSet en el host de cliente de kubectl ejecutando el siguiente comando.

        curl -O  https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/k8s-deployment-manifest-templates/deployment-mode/daemonset/container-insights-monitoring/cwagent/cwagent-daemonset.yaml

     2. Borre el comentario de la sección port en el archivo cwagent-daemonset.yaml como se indica a continuación:

        ports:
          - containerPort: 8125
            hostPort: 8125
            protocol: UDP
        

     3. Implemente el agente de CloudWatch en el clúster con el siguiente comando.

        kubectl apply -f cwagent-daemonset.yaml

     4. Implemente el agente de CloudWatch en los nodos de Windows de su clúster ejecutando el siguiente comando. El oyente StatsD no es compatible con el agente de CloudWatch en Windows.

        kubectl apply -f cwagent-daemonset-windows.yaml

2. Compruebe que el agente está implementado ejecutando el siguiente comando.

   kubectl get pods -n amazon-cloudwatch