Erfassen von Prometheus-Metriken in den Workspace

Eine Möglichkeit, Metriken zu erfassen, besteht darin, einen eigenständigen Prometheus-Agenten (eine Prometheus-Instance, die im Agentenmodus läuft) zu verwenden, um Metriken aus Ihrem Cluster zu extrahieren und sie zur Speicherung und Überwachung an Amazon Managed Service für Prometheus weiterzuleiten. In diesem Abschnitt wird erklärt, wie Sie die Erfassung von Metriken in Ihren Workspace in Amazon Managed Service für Prometheus von Amazon EKS einrichten, indem Sie mithilfe des Befehls „Helm“ eine neue Instance des Prometheus-Agents einrichten.

Informationen zu anderen Möglichkeiten, Daten in Amazon Managed Service für Prometheus zu erfassung, einschließlich der Sicherung von Metriken und der Erstellung von Hochverfügbarkeitsmetriken, finden Sie unter Nehmen Sie Metriken in Ihren Amazon Managed Service for Prometheus-Workspace auf.

Anmerkung

In einen Workspace aufgenommene Metriken werden standardmäßig 150 Tage lang gespeichert und dann automatisch gelöscht. Bei dieser Länge handelt es sich um ein einstellbares Kontingent.

Mit den Anweisungen in diesem Abschnitt können Sie Amazon Managed Service für Prometheus schnell einrichten. Es wird davon ausgegangen, dass Sie bereits einen Arbeitsbereich erstellt haben. In diesem Abschnitt richten Sie einen neuen Prometheus-Server in einem Amazon EKS-Cluster ein, und der neue Server verwendet eine Standardkonfiguration, um als Agent Metriken an Amazon Managed Service for Prometheus zu senden. Für diese Methode müssen die folgenden Voraussetzungen erfüllt sein:

• Sie benötigen einen Amazon EKS-Cluster, aus dem der neue Prometheus-Server Metriken sammelt.

• In Ihrem Amazon EKS-Cluster muss ein Amazon EBS CSI-Treiber installiert sein (von Helm erforderlich).

• Sie müssen Helm CLI 3.0 oder höher verwenden.

• Sie müssen einen Linux- oder macOS-Computer verwenden, um die Schritte in den folgenden Abschnitten auszuführen.

Schritt 1: Hinzufügen neuer Helm-Chart-Repositorys

Geben Sie die folgenden Befehle ein, um neue Helm-Chart-Repositorys hinzuzufügen. Weitere Informationen zu diesen Befehlen finden Sie unter Helm Repo.

helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo add kube-state-metrics https://kubernetes.github.io/kube-state-metrics
helm repo update

Schritt 2: Erstellen eines Prometheus-Namespace

Geben Sie den folgenden Befehl ein, um einen Prometheus-Namespace für den Prometheus-Server und andere Monitoring-Komponenten zu erstellen. prometheus-agent-namespaceErsetzen Sie es durch den Namen, den Sie für diesen Namespace verwenden möchten.

kubectl create namespace prometheus-agent-namespace

Schritt 3: Einrichten von IAM-Rollen für Servicekonten

Für diese Erfassungsmethode müssen Sie IAM-Rollen für Servicekonten im Amazon-EKS-Cluster verwenden, in dem der Prometheus-Agent ausgeführt wird.

Mit IAM-Rollen für Servicekonten können Sie eine IAM-Rolle mit einem Kubernetes-Servicekonto verknüpfen. Dieses Servicekonto kann dann AWS -Berechtigungen für die Container in einem beliebigen Pod bereitstellen, der dieses Servicekonto verwendet. Weitere Informationen finden Sie unter IAM-Rollen für Servicekonten.

Wenn Sie diese Rollen noch nicht eingerichtet haben, folgen Sie den Anweisungen unter Richten Sie Servicerollen für die Erfassung von Metriken aus Amazon EKS-Clustern ein, um die Rollen einzurichten. Die Anweisungen in diesem Abschnitt erfordern die Verwendung von eksctl. Weitere Informationen finden Sie unter Erste Schritte mit Amazon Elastic Kubernetes Service – eksctl.

Anmerkung

Wenn Sie nicht auf EKS oder sind AWS und nur den Zugriffsschlüssel und den geheimen Schlüssel für den Zugriff auf Amazon Managed Service for Prometheus verwenden, können Sie das EKS-IAM-ROLE basierte SigV4 nicht verwenden.

Schritt 4: Einrichten des neuen Servers und Beginn der Erfassung von Metriken

Gehen Sie wie folgt vor, um den neuen Prometheus Agenten zu installieren und Messwerte an Ihren Workspace in Amazon Managed Service für Prometheus zu senden.

Um einen neuen Prometheus Agenten zu installieren und Messwerte an Ihren Workspace in Amazon Managed Service für Prometheus zu senden

1. Erstellen Sie mithilfe eines Texteditors eine Datei mit dem Namen my_prometheus_values_yaml mit folgenden Inhalten.

   • Ersetzen Sie IAM_PROXY_PROMETHEUS_ROLE_ARN durch den ARN, den Sie in erstellt haben. amp-iamproxy-ingest-roleRichten Sie Servicerollen für die Erfassung von Metriken aus Amazon EKS-Clustern ein

   • Ersetzen Sie WORKSPACE_ID durch die ID Ihres Workspace in Amazon Managed Service für Prometheus.

   • Ersetzen Sie REGION durch die Region Ihres Workspace in Amazon Managed Service für Prometheus.

   ## The following is a set of default values for prometheus server helm chart which enable remoteWrite to AMP
   ## For the rest of prometheus helm chart values see: https://github.com/prometheus-community/helm-charts/blob/main/charts/prometheus/values.yaml
   ##
   serviceAccounts:
     server:
       name: amp-iamproxy-ingest-service-account
       annotations: 
         eks.amazonaws.com/role-arn: ${IAM_PROXY_PROMETHEUS_ROLE_ARN}
   server:
     remoteWrite:
       - url: https://aps-workspaces.${REGION}.amazonaws.com/workspaces/${WORKSPACE_ID}/api/v1/remote_write
         sigv4:
           region: ${REGION}
         queue_config:
           max_samples_per_send: 1000
           max_shards: 200
           capacity: 2500

2. Geben Sie den folgenden Befehl ein, um den Prometheus-Server zu starten.

   • Ersetzen Sie es prometheus-chart-namedurch Ihren Prometheus-Versionsnamen.

   • Ersetzen Sie es prometheus-agent-namespacedurch den Namen Ihres Prometheus-Namespaces.

   helm install prometheus-chart-name prometheus-community/prometheus -n prometheus-agent-namespace \
   -f my_prometheus_values_yaml