Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # 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. **Topics** + [Schritt 1: Einrichten von IAM-Rollen für Servicekonten](#AMP-onboard-existing-Prometheus-IRSA) + [Schritt 2: Aktualisieren Sie Ihren vorhandenen Prometheus-Server mithilfe von Helm](#AMP-onboard-ingest-metrics-existing-remotewrite) ## 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](https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts.html). Wenn Sie diese Rollen noch nicht eingerichtet haben, folgen Sie den Anweisungen unter [Einrichten von Servicerollen für die Erfassung von Metriken aus Amazon-EKS-Clustern](set-up-irsa.md#set-up-irsa-ingest), 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 haben[Schritt 1: Einrichten von IAM-Rollen für Servicekonten](#AMP-onboard-existing-Prometheus-IRSA). 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 ``` 1. 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](https://helm.sh/docs/helm/helm_list/) 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 haben[Schritt 1: Einrichten von IAM-Rollen für Servicekonten](#AMP-onboard-existing-Prometheus-IRSA). 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. 1. 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-name}}Ersetzen Sie es durch den Namen der Prometheus-Helmkarte, die im vorherigen Befehl zurückgegeben wurde. Ersetzen Sie {{prometheus-namespace}} durch den Namen Ihres Namespaces. #### 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 ```