Überwachung der Anwendung „ IBM API Connect “
IBM API Connect Die Überwachung der Anwendungslaufzeit konzentriert sich auf die Beobachtung wichtiger Kennzahlen zur Anwendungsleistung in der Produktion, insbesondere der Transaktionen über DataPower API Gateway. Der „ Instana “-Agent kann automatisch Metriken zu Infrastrukturressourcen erfassen. Damit der Agent jedoch Trace-Informationen aus „ IBM API Connect “ erfassen kann, müssen Sie die in diesem Thema beschriebenen zusätzlichen Schritte ausführen.
Kennzahlen für „ DataPower “ API Gateway
Der Sensor Instana DataPower dient zur Überwachung von DataPower API Gateway. Nach der Installation des Host-Agenten „ Instana “ wird der Sensor „ IBM DataPower “ automatisch installiert; den Sensor „ IBM DataPower “ müssen Sie jedoch konfigurieren. Weitere Informationen finden Sie unter „Überwachung“ IBM DataPower.
Verfolgung für DataPower API Gateway
Die Funktion „ Instana “ ( DataPower-tracing ) ermöglicht es, die Funktion „ API Management “ zu überwachen und zu überprüfen, wie APIs in „ DataPower “ ( API Gateway ) gestartet werden.
Instana DataPower Tracing unterstützt nur das Szenario, bei dem die „ DataPower “-Instanz über den „ API Connect “-Operator in „ Red Hat OpenShift “ mit den folgenden Versionen bereitgestellt wird:
- API Connect Operator 3.5.0 und höher und älter als 5.2.0
- API Connect 10.0.5.5 und höher als 10.0.8.0
- DataPower Gateway Operator 1.6.10 und höher als 1.11.0
Für die Bereitstellung von „ IBM API Connect “ auf „ VMware “ müssen Sie eine „ DataPower Gateway “-Appliance bereitstellen. In der Regel wird die physische Appliance „ DataPower “ oder die virtuelle Appliance „ DataPower “ als „ API Gateway “ verwendet. Wenn Sie die Protokollierung für die physische Appliance „ DataPower “ oder die virtuelle Appliance „ DataPower “ aktivieren möchten, lesen Sie den Abschnitt „ IBM DataPower -Protokollierung “.
Um die Traceerstellung für DataPower API Gatewayzu aktivieren, müssen Sie DataPower Tracing Agent installieren und konfigurieren.
Installieren Sie den „ DataPower “-Tracing-Agenten
Wenn Sie Jaeger -Tracing für DataPower, bearbeiten Sie die GatewayCluster Benutzerdefinierte Ressource zum Ersetzen des Jaeger Tracing-Agent-Images durch das Instana DataPower Tracing-Agent-Image. Falls Sie die Protokollierung von „ Jaeger “ für „ DataPower, “ jedoch nicht aktiviert haben, bearbeiten Sie die GatewayCluster benutzerdefinierte Ressource, um die Eigenschaft „ jaegerTracing “ hinzuzufügen, und setzen Sie anschließend das Attribut „image“ auf „ Instana “ – das Bild des „ DataPower Tracing Agent“ URL.
Um den Sidecar-Container des „ Instana “-Tracing-Agenten zu konfigurieren und auszuführen, bearbeiten Sie die GatewayCluster benutzerdefinierte Ressource, indem Sie die Eigenschaft „ jaegerTracing “ in der folgenden Datei „ YAML “ hinzufügen oder bearbeiten:
spec:
jaegerTracing:
samplingType: const
propagationFormat: w3c
samplingRate: '1'
agentImage: 'icr.io/instana/instana-dp-agent-image:latest'
tls:
disabled: true
skipHostVerify: false
env:
- name: INSTANA_AGENT_HOST
valueFrom:
fieldRef:
apiVersion: v1
fieldPath: status.hostIP
Weitere Informationen finden Sie in der Dokumentation jaegerTracing zum Operator unter DataPower.
Überprüfen Sie das Ergebnis in der Red Hat OpenShift -Konsole wie im folgenden Beispiel:
Sie können die Trace-Daten von IBM API Connect API Gateway in der Benutzeroberfläche von Instana einsehen. Der Standard-Dienstname von „ DataPower -Tracing“ lautet beispielsweise datapower:<datapower pod name>. datapower:apis-minimum-gw-0
Weitere Informationen finden Sie unter Instana unter „Agent-Anforderungen für die Installation des Host-Agenten“ auf Kubernetes.
Den Tracing-Agenten von „ DataPower “ deaktivieren
Um den Tracing-Agenten „ DataPower “ zu deaktivieren, entfernen Sie die Eigenschaft „ jaegerTracing “ aus der entsprechenden GatewayCluster benutzerdefinierten Ressource in der Datei „ YAML “.
Bekannte Einschränkungen
- DataPower Die Nachverfolgung unterstützt nur das „ API “-Gateway und keine anderen Dienste wie das Multiprotokoll-Gateway oder den Webdienst-Proxy.
Anwendungsperspektive erstellen
Führen Sie die folgenden Schritte aus, um eine Anwendungsperspektive zu erstellen, mit der Sie Trace-Informationen anzeigen können, die während der Laufzeit einer „ IBM API Connect “-Anwendung erfasst wurden:
- Öffnen Sie den Assistenten für die Anwendungsperspektive auf eine der folgenden Arten:
- Klicken Sie im Dashboard „ Instana “ in der Liste „Anwendungen“ auf „Neue Anwendungsperspektive “.
- Go Gehen Sie im Dashboard von „ Instana “ im Navigationsbereich auf „Anwendungen “ und klicken Sie auf der Seite „Anwendungen“ auf „Hinzufügen“ > „Neue Anwendungsperspektive “.
- Wählen Sie Services oder Endpunkteaus und klicken Sie auf Next.
- Klicken Sie auf Filter hinzufügenund wählen Sie dann einen Servicenamen aus. Mithilfe von
OR-Bedingungen können mehrere Services und Endpunkte ausgewählt werden. Für den DataPower -Service lautet der Servicenamedatapower:<datapower-appliance-name>, z. B.datapower:apis-minimum-gw-0. - Geben Sie im Feld „Name der Anwendungsperspektive“ einen Namen für die Anwendungsperspektive „ IBM API Connect “ ein und klicken Sie anschließend auf „Erstellen “.
Fehlerbehebung
DataPower fehlt Anrufe in der Benutzeroberfläche von „ Instana “ nachverfolgen
Wenn die Anrufe zur Rückverfolgung von „ DataPower “ nicht wie erwartet in der Benutzeroberfläche von „ Instana “ angezeigt werden, führen Sie die folgenden Schritte aus:
- Debugging für die Ablaufverfolgung von „ Instana “ aktivieren: DataPower
- Greifen Sie auf den DataPower -Pod zu und wechseln Sie in das Verzeichnis
/app/libsim Containerjaeger-tracing-agent. - Bearbeiten Sie die Datei
logback.xml, indem Sie<root level="info">in<root level="debug">ändern. Die Änderung wird in einer Minute wirksam.
- Greifen Sie auf den DataPower -Pod zu und wechseln Sie in das Verzeichnis
- Verwenden Sie den
oc logs <datapower-pod-name> -c jaeger-tracing-agentBefehl, um die Debugging-Informationen des Tracing-Agenten von „ Instana “ DataPower zu erfassen.