Migration vom „ AWS “-SDK ( v1 ) zum „ AWS “-SDK ( v2 )

Überwachung der Kontinuität

Ihre „ AWS “-Überwachung bleibt während des gesamten Migrationsprozesses voll funktionsfähig, ohne dass es zu Unterbrechungen bei der Datenerfassung oder der Transparenz Ihrer „ AWS “-Ressourcen kommt.

Beibehaltung der Konfiguration

Ihre bestehenden Konfigurationen in „ AWS “, einschließlich IAM-Rollen und -Richtlinien, Zugriffsschlüsseln und Anmeldedaten, Konfigurationen für den „ AWS “-Dienst sowie Netzwerkeinstellungen, bleiben unverändert.

Anforderung zum Neustart des Agenten

Zur Aktivierung von „ AWS “-Sensoren, die das „ AWS “-SDK verwenden, ist lediglich ein kurzer Neustart des Agenten erforderlich: v2. Der Neustart erfolgt gemäß den üblichen Verfahren zur Aktualisierung des Agenten und verursacht nur minimale Ausfallzeiten.

Zukünftige Verbesserungen

Alle neuen Funktionen und Verbesserungen des „ AWS “-Sensors werden ausschließlich mithilfe des „ AWS “-SDK ( v2 ) entwickelt, sodass Sie stets Zugriff auf die neuesten Funktionen haben.

Hostbasierte Bereitstellungen

Der „ Instana “-Agent wird mit dem Azul- JVM oder OpenJ9 JVM ausgeliefert. Die Migrationsschritte unterscheiden sich geringfügig, je nachdem, welche Version von „ JVM “ Sie verwenden.

Weitere Informationen zur Konfiguration von „ JVM “ finden Sie unter „Installation des Agenten“ auf Linux.

Sie können mithilfe einer der folgenden Optionen auf das SDK „ AWS “ unter v2 umsteigen:

Option 1: Automatische Migration (empfohlen)

Installieren Sie den Dynamic- Instana -Agenten neu, um Änderungen am „ AWS “-SDK v2 und Anpassungen der Speicherkonfiguration automatisch zu übernehmen.

Option 2: Manuelle Konfiguration

1. Bearbeite die Datei /opt/instana/agent/bin/memory-config.
2. Fügen Sie unter INSTANA_AGENT_MEMORY_CONFIGURATION_OPTS die folgenden Parameter hinzu:

   -XX:CompressedClassSpaceSize=48m \
   -XX:MaxMetaspaceSize=256m \

3. Erhöhen Sie den Arbeitsspeicher des Agenten, indem Sie die Umgebungsvariable AGENT_MAX_MEM = setzen768M.
4. Führen Sie die verbleibenden Schritte für Ihren „ JVM “-Typ wie in den folgenden Abschnitten beschrieben durch.

Neustart des Agenten

Starten Sie den Agenten nach Abschluss der Konfigurationsschritte neu, um die „ AWS “-Sensoren mit dem „ AWS “-SDK zu aktivieren: v2:

1. Starten Sie den Agenten erneut.

   sudo systemctl restart instana-agent

2. Überprüfen Sie, ob der Agent ausgeführt wird.

   sudo systemctl status instana-agent

Für „ OpenJ9 “ ( JVM ) ist außer dem Neustart keine weitere Konfiguration erforderlich.

Docker Bereitstellungen

Für „ Docker “-basierte „ Instana “-Agenten sollten Sie Ihren Agent-Container auf die neueste Version aktualisieren, die Unterstützung für das „ AWS SDK“ ( v2 ) enthält. Der Aktualisierungsprozess umfasst das Herunterladen des neuesten Images, das Beenden des bestehenden Containers und das Starten eines neuen Containers mit dem aktualisierten Image.

Weitere Informationen zu den Upgrade-Anweisungen finden Sie unter „Upgrade des Container-Images für den Agenten von Instana “.

Kubernetes sowie Helm -Bereitstellungen

Bei „ Kubernetes “-Bereitstellungen erfolgt die Migration über ein rollierendes Upgrade auf Basis von „ Helm “. Kubernetes führt automatisch ein rollierendes Update durch, bei dem neue Pods mit aktualisierten Konfigurationen starten und bestehende Pods ordnungsgemäß beendet werden, sobald die neuen Pods bereit sind, wodurch eine Bereitstellung ohne Ausfallzeiten und eine kontinuierliche Überwachung gewährleistet werden.

Ausführliche Anweisungen finden Sie unter „Verwalten des Agenten für den Dienst „ Instana ““ auf Kubernetes.

Beispiele für Upgrade-Befehle:

# Update Helm repository
helm repo update

# Upgrade the Instana agent
helm upgrade instana-agent instana/instana-agent \
  --namespace instana-agent \
  --reuse-values

# Verify the rollout status
kubectl rollout status daemonset/instana-agent -n instana-agent

Agentenprotokolle überprüfen

Sehen Sie sich die Agent-Protokolle an, um die Initialisierung des „ AWS “-SDK unter v2 zu überprüfen und sicherzustellen, dass keine Fehler vorliegen.

Für hostbasierte Bereitstellungen:

sudo journalctl -u instana-agent -f

Für „ Docker “-Bereitstellungen:

docker logs -f instana-agent

Für „ Kubernetes “-Bereitstellungen:

kubectl logs -f daemonset/instana-agent -n instana-agent

Überprüfung der Dienstermittlung bei „ AWS “

1. Melden Sie sich bei der Benutzeroberfläche von „ Instana “ an.
2. Klicken Sie im Navigationsmenü auf Infrastruktur > AWS.
3. Stellen Sie sicher, dass Ihre Ressourcen unter AWS erkannt und überwacht werden.
4. Überprüfen Sie, ob Metriken von Ihren „ AWS “-Diensten erfasst werden.

Unterstützung

Sollten während der Migration Probleme auftreten oder sollten Sie Fragen haben, wenden Sie sich bitte über Ihr IBM -Supportportal an den IBM -Support.