Richten Sie die Aufnahme von einem vorhandenen Prometheus-Server in Kubernetes ein auf EC2 - Amazon Managed Service für Prometheus

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 Aufnahme von einem vorhandenen Prometheus-Server in Kubernetes ein auf EC2

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

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

Schritt 1: Rollen für Dienstkonten einrichten IAM

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

Mit Servicerollen können Sie eine IAM Rolle einem Kubernetes-Servicekonto zuordnen. Dieses Dienstkonto kann dann AWS Berechtigungen für die Container in jedem Pod gewähren, der dieses Dienstkonto verwendet. Weitere Informationen finden Sie unter IAMRollen für Dienstkonten.

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 ihn durch ARN den amp-iamproxy-ingest-role, den Sie in erstellt habenSchritt 1: Rollen für Dienstkonten einrichten IAM. Die Rolle ARN sollte das Format von habenarn:aws:iam::your account ID:role/amp-iamproxy-ingest-role.

    • 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 Datei die folgenden Werte hinzu. YAML

    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 das ARN amp-iamproxy-ingest-role, in dem Sie es erstellt habenSchritt 1: Rollen für Dienstkonten einrichten IAM. Die Rolle ARN sollte das Format von habenarn:aws:iam::your account ID:role/amp-iamproxy-ingest-role.

    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

    Ersetzen prometheus-helm-chart-name mit dem Namen der Prometheus-Helmkarte, die im vorherigen Befehl zurückgegeben wurde. Ersetzen prometheus-namespace mit dem 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