Richten Sie die Erfassung von einem vorhandenen Prometheus-Server in Kubernetes auf EC2 ein

Amazon Managed Service für Prometheus unterstützt die Erfassung von Metriken von Prometheus-Servern in Clustern, auf denen Amazon EKS ausgeführt wird, und in selbstverwalteten Kubernetes-Clustern, die auf Amazon EC2 ausgeführt werden. Die detaillierten Anweisungen in diesem Abschnitt beziehen sich auf einen Prometheus-Server in einem Amazon-EKS-Cluster. Die Schritte für einen selbstverwalteten Kubernetes-Cluster auf Amazon EC2 sind dieselben, mit der Ausnahme, dass Sie die OIDC-Anbieter- und IAM-Rollen für Servicekonten selbst im Kubernetes-Cluster einrichten müssen.

In den Anweisungen in diesem Abschnitt wird Helm als Kubernetes-Paketmanager verwendet.

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

Für die Onboarding-Methode, die wir dokumentieren, müssen Sie IAM-Rollen für Servicekonten im Amazon-EKS-Cluster verwenden, in dem der Prometheus-Server läuft. Diese Rollen werden als Servicerollen bezeichnet.

Mit Servicerollen können Sie eine IAM-Rolle mit einem Kubernetes-Servicekonto verknüpfen. Dieses Dienstkonto kann dann AWS Berechtigungen für die Container in jedem Pod gewähren, der dieses Dienstkonto 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.

Schritt 2: Aktualisieren Sie Ihren vorhandenen Prometheus-Server mithilfe von Helm

Die Anweisungen in diesem Abschnitt beinhalten die Einrichtung von Remote-Write und SigV4 zur Authentifizierung und Autorisierung des Prometheus-Servers für Remote–Write in Ihrem Workspace in Amazon Managed Service für Prometheus.

Verwenden von Prometheus Version 2.26.0 oder höher

Gehen Sie wie folgt vor, wenn Sie einen Helm-Chart mit einem Prometheus Server-Image der Version 2.26.0 oder höher verwenden.

So richten Sie Remote-Write von einem Prometheus-Server aus mithilfe von Helm-Chart ein

1. Erstellen Sie einen neuen Remote-Write-Abschnitt in Ihrer Helm-Konfigurationsdatei:

   • ${IAM_PROXY_PROMETHEUS_ROLE_ARN}Ersetzen Sie es durch den ARN des amp-iamproxy-ingest-role, in dem Sie es erstellt habenSchritt 1: Einrichten von IAM-Rollen für Servicekonten. Der Rollen-ARN sollte das Format arn:aws:iam::your account ID:role/amp-iamproxy-ingest-role haben.

   • Ersetzen Sie ${WORKSPACE_ID} durch Ihre Workspace-ID von Amazon Managed Service für Prometheus.

   • Ersetzen Sie ${REGION} durch die Region des Workspace in Amazon Managed Service für Prometheus (z. B. us-west-2).

   ## 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. Aktualisieren Sie Ihre bestehende Prometheus-Server-Konfiguration mit Helm:

   • Ersetzen Sie prometheus-chart-name durch Ihren Prometheus-Versionsnamen.

   • Ersetzen Sie prometheus-namespace durch den Kubernetes-Namespace, in dem Ihr Prometheus-Server installiert ist.

   • Ersetzen Sie my_prometheus_values_yaml durch den Pfad zu Ihrer Helm-Konfigurationsdatei.

   • Ersetzen Sie current_helm_chart_version durch die aktuelle Version Ihres Prometheus-Server-Helm-Charts. Sie können die aktuelle Chart-Version finden, indem Sie den Befehl Helmliste verwenden.

   helm upgrade prometheus-chart-name prometheus-community/prometheus \
          -n prometheus-namespace \
          -f my_prometheus_values_yaml \
          --version current_helm_chart_version

Verwenden früherer Versionen von Prometheus

Gehen Sie wie folgt vor, wenn Sie eine ältere Version von Prometheus als 2.26.0 verwenden. Bei diesen Schritten wird ein Sidecar-Ansatz verwendet, da frühere Versionen von Prometheus den Signaturprozess von AWS Signature Version 4 (Sigv4) nicht nativ unterstützen.AWS

Bei diesen Anleitungen wird davon ausgegangen, dass Sie Helm verwenden, um Prometheus bereitzustellen.

So richten Sie Remote-Write von einem Prometheus-Server aus ein

1. Erstellen Sie auf Ihrem Prometheus-Server eine neue Remote-Write-Konfiguration. Erstellen Sie zunächst eine neue Aktualisierungsdatei. Wir werden die Datei amp_ingest_override_values.yaml aufrufen.

   Fügen Sie der YAML-Datei die folgenden Werte hinzu.

   serviceAccounts:
           server:
               name: "amp-iamproxy-ingest-service-account"
               annotations:
                   eks.amazonaws.com/role-arn: "${SERVICE_ACCOUNT_IAM_INGEST_ROLE_ARN}"
       server:
           sidecarContainers:
               - name: aws-sigv4-proxy-sidecar
                 image: public.ecr.aws/aws-observability/aws-sigv4-proxy:1.0
                 args:
                 - --name
                 - aps
                 - --region
                 - ${REGION}
                 - --host
                 - aps-workspaces.${REGION}.amazonaws.com
                 - --port
                 - :8005
                 ports:
                 - name: aws-sigv4-proxy
                   containerPort: 8005
           statefulSet:
               enabled: "true"
           remoteWrite:
               - url: http://localhost:8005/workspaces/${WORKSPACE_ID}/api/v1/remote_write

   Ersetzen Sie ${REGION} durch die Region des Workspace in Amazon Managed Service für Prometheus.

   ${SERVICE_ACCOUNT_IAM_INGEST_ROLE_ARN}Ersetzen Sie es durch den ARN des amp-iamproxy-ingest-role, in dem Sie es erstellt habenSchritt 1: Einrichten von IAM-Rollen für Servicekonten. Der Rollen-ARN sollte das Format arn:aws:iam::your account ID:role/amp-iamproxy-ingest-role haben.

   Ersetzen Sie ${WORKSPACE_ID} durch Ihre Workspace-ID.

2. Aktualisieren Sie Ihr Prometheus Helm-Chart. Suchen Sie zunächst nach dem Namen Ihres Helm-Charts, indem Sie den folgenden Befehl eingeben. Suchen Sie in der Ausgabe dieses Befehls nach einem Chart mit einem Namen, der prometheus enthält:

   helm ls --all-namespaces

   Geben Sie dann den folgenden Befehl ein.

   helm upgrade --install prometheus-helm-chart-name prometheus-community/prometheus -n prometheus-namespace -f ./amp_ingest_override_values.yaml

   prometheus-helm-chart-nameErsetzen Sie es durch den Namen des Prometheus-Helmdiagramms, das im vorherigen Befehl zurückgegeben wurde. Ersetzen Sie prometheus-namespace durch den Namen Ihres Namespace.

Helm-Charts werden heruntergeladen

Wenn Sie Helm-Charts noch nicht lokal heruntergeladen haben, können Sie sie mit dem folgenden Befehl herunterladen.

helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
    helm pull prometheus-community/prometheus --untar