Einrichtung des CloudWatch-Agenten zur Sammlung von Cluster-Metriken

Erstellen eines Namespace für CloudWatch

• Geben Sie den folgenden Befehl ein.

  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

So nutzen Sie kubectl zum Erstellen eines Servicekontos für den CloudWatch-Agenten

• Geben Sie den folgenden Befehl ein.

  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

So erstellen Sie eine ConfigMap für den CloudWatch-Agenten

1. Laden Sie die ConfigMap-YAML auf Ihren kubectl-Client-Host herunter, indem Sie den folgenden Befehl ausführen:

   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. Bearbeiten Sie die heruntergeladene YAML-Datei wie folgt:

   • cluster_name – Ersetzen Sie im Abschnitt kubernetes den Platzhalter {{cluster_name}} durch den Namen Ihres Clusters. Entfernen Sie die Zeichen {{}}. Wenn Sie einen Amazon-EKS-Cluster verwenden, können Sie das Feld "cluster_name" und den Wert löschen. In diesem Fall erkennt der CloudWatch-Agent den Cluster-Namen aus den Amazon-EC2-Tags.

3. (Optional) Nehmen Sie wie folgt weitere Änderungen an der ConfigMap basierend auf Ihren Überwachungsanforderungen vor:

   • metrics_collection_interval – Im Abschnitt kubernetes können Sie angeben, wie oft der Agent Metriken sammelt. Standardmäßig ist ein Zeitraum von 60 Sekunden festgelegt. Das standardmäßige cadvisor-Erfassungsintervall in Kubelet beträgt 15 Sekunden. Stellen Sie für diesen Wert also nicht weniger als 15 Sekunden ein.

   • endpoint_override – Im Abschnitt logs können Sie den CloudWatch-Logs-Endpunkt angeben, wenn Sie den Standardendpunkt überschreiben möchten. Dies ist sinnvoll, wenn Sie aus einem Cluster in einer VPC veröffentlichen und die Daten zu einem VPC-Endpunkt weiterleiten möchten.

   • force_flush_interval – Im Abschnitt logs können Sie das Intervall für die Stapelverarbeitung von Protokollereignissen angeben, bevor sie in CloudWatch Logs veröffentlicht werden. Standardmäßig ist ein Zeitraum von 5 Sekunden festgelegt.

   • Region – Standardmäßig veröffentlicht der Agent Metriken in der Region, in der sich der Workerknoten befindet. Um diese Einstellung zu überschreiben, können Sie ein region-Feld zum Abschnitt agent hinzufügen. Beispiel: "region":"us-west-2".

   • statsd-Abschnitt – Wenn Sie möchten, dass der CloudWatch-Logs-Agent in jedem Worker-Knoten Ihres Clusters auch als StatsD-Listener ausgeführt wird, können Sie wie im folgenden Beispiel einen statsd-Abschnitt zum Abschnitt metrics hinzufügen. Weitere Informationen zu anderen StatsD-Optionen für diesen Abschnitt finden Sie unter Abrufen benutzerdefinierter Metriken mit StatsD.

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

     Ein vollständiges Beispiel für den JSON-Abschnitt lautet wie folgt. Wenn Sie eine kubeconfig-Datei für die Authentifizierung nutzen, fügen Sie den kube_config_path-Parameter hinzu, um den Pfad zu Ihrer kubeconfig-Datei anzugeben.

     {
         "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. Erstellen Sie die ConfigMap im Cluster, indem Sie den folgenden Befehl ausführen.

   kubectl apply -f cwagent-configmap-enhanced.yaml

So stellen Sie den CloudWatch-Agenten als DaemonSet bereit

1. • Wenn Sie StatsD nicht auf dem Cluster verwenden möchten, geben Sie den folgenden Befehl ein.

     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

   • Wenn Sie StatsD verwenden möchten, führen Sie die folgenden Schritte aus:

     1. Laden Sie die DaemonSet-YAML auf Ihren kubectl-Client-Host herunter, indem Sie den folgenden Befehl ausführen.

        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. Heben Sie die Kommentierung des port-Abschnitts in der cwagent-daemonset.yaml-Datei wie folgt auf:

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

     3. Stellen Sie den CloudWatch-Agenten in Ihrem Cluster bereit, indem Sie den folgenden Befehl ausführen.

        kubectl apply -f cwagent-daemonset.yaml

     4. Stellen Sie den CloudWatch-Agenten auf Windows-Knoten in Ihrem Cluster bereit, indem Sie den folgenden Befehl ausführen. Der StatsD-Listener wird auf dem CloudWatch-Agenten unter Windows nicht unterstützt.

        kubectl apply -f cwagent-daemonset-windows.yaml

2. Überprüfen Sie, ob der Agent bereitgestellt wird, indem Sie den folgenden Befehl ausführen.

   kubectl get pods -n amazon-cloudwatch