Monitoraggio dell'applicazion IBM API Connect
IBM API Connect Il monitoraggio del runtime delle applicazioni si concentra sul monitoraggio delle principali metriche relative alle prestazioni delle applicazioni in produzione, in particolare delle transazioni, tramite DataPower API Gateway. L'agente di Instana è in grado di raccogliere automaticamente le metriche delle risorse dell'infrastruttura, ma per consentirgli di raccogliere le informazioni di tracciamento da IBM API Connect è necessario completare i passaggi aggiuntivi descritti in questo argomento.
Metriche per DataPower API Gateway
Il sensore Instana DataPower viene utilizzato per monitorare DataPower API Gateway. Dopo aver installato l'agente host di Instana, il sensore IBM DataPower viene installato automaticamente, ma è necessario configurare il sensore IBM DataPower. Per ulteriori informazioni, consultare la sezione "Monitoraggio" all'indirizzo IBM DataPower.
Tracciamento per DataPower API Gateway
La funzione " Instana " ( DataPower-tracing ) consente di monitorare la funzionalità " API Management " e di verificare come vengono avviate le API in " DataPower " ( API Gateway ).
Instana DataPower Il tracciamento supporta solo lo scenario in cui l'istanza di DataPower è distribuita tramite l'operatore API Connect in Red Hat OpenShift con le seguenti versioni:
- Operatore API Connect 3.5.0 e successive e precedenti a 5.2.0
- API Connect 10.0.5.5 e versioni successive e precedenti a 10.0.8.0
- DataPower Gateway 1.6.10 e versioni successive e precedenti a 1.11.0
Per l'implementazione di un IBM API Connect su VMware, è necessario implementare un'appliance DataPower Gateway. Di solito, come server di controllo ( API Gateway ) viene utilizzato l'appliance fisica DataPower o l'appliance virtuale DataPower. Se desideri abilitare il tracciamento per un'appliance fisica di DataPower o per un'appliance virtuale di DataPower, consulta la sezione "Tracciamento" all'indirizzo IBM DataPower.
Per abilitare la traccia per DataPower API Gateway, è necessario installare e configurare l'agent di traccia DataPower .
Installa l'agente di tracciamento di DataPower
Se hai abilitato il tracciamento di Jaeger per DataPower,, modifica la risorsa GatewayCluster personalizzata per sostituire l'immagine dell'agente di tracciamento Jaeger con l'immagine dell'agente di tracciamento Instana DataPower. Tuttavia, se non hai abilitato il tracciamento di Jaeger per DataPower,, modifica la risorsa GatewayCluster personalizzata per aggiungere la proprietà jaegerTracing, quindi imposta l'attributo image su Instana DataPower Immagine dell'agente di tracciamento URL.
Per configurare ed eseguire il container sidecar dell'agente di tracciamento di Instana, modificare la risorsa GatewayCluster personalizzata aggiungendo o modificando la proprietà ` jaegerTracing ` nel seguente file ` YAML `:
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
Per ulteriori informazioni su jaegerTracing, consultare la documentazione relativa all'operatore DataPower.
Verifica il risultato sulla console Red Hat OpenShift come nel seguente esempio:
È possibile visualizzare i dati di tracciamento di IBM API Connect e API Gateway nell'interfaccia utente di Instana. Il nome servizio predefinito di DataPower Tracing è datapower:<datapower pod name>, ad esempio datapower:apis-minimum-gw-0.
Per ulteriori informazioni, consultare la pagina Instana Requisiti dell'agente per l'installazione dell'agente host all'indirizzo Kubernetes.
Disattivare l'agente di tracciamento di DataPower
Per disattivare l'agente di tracciamento di DataPower, rimuovere la proprietà ` jaegerTracing ` dalla risorsa personalizzata GatewayCluster corrispondente nel file ` YAML `.
Limitazioni note
- DataPower Il tracciamento supporta solo il gateway " API " e non supporta altri servizi, come il gateway multiprotocollo e il proxy per servizi web.
Creazione di una prospettiva dell'applicazione
Per creare una prospettiva dell'applicazione che consenta di visualizzare le informazioni di tracciamento raccolte durante l'esecuzione di un'applicazion IBM API Connect, procedere come segue:
- Aprire la procedura guidata della prospettiva applicazione in uno dei seguenti modi:
- Fai clic su "Nuova prospettiva dell'applicazione" nell'elenco delle applicazioni nella dashboard di Instana.
- Go selezionare "Applicazioni" nel pannello di navigazione della dashboard di Instana, quindi fare clic su "Aggiungi" > "Nuova prospettiva dell'applicazione" nella pagina "Applicazioni".
- Selezionare Servizi o endpoint, quindi fare clic su Avanti.
- Fare clic su Aggiungi filtro, quindi selezionare un nome servizio. È possibile selezionare più servizi ed endpoint utilizzando condizioni
OR. Per il servizio DataPower , il nome del servizio è simile adatapower:<datapower-appliance-name>, ad esempiodatapower:apis-minimum-gw-0. - Nel campo "Nome prospettiva dell'applicazione ", immettere un nome per la prospettiva dell'applicazione " IBM API Connect ", quindi fare clic su "Crea".
Risoluzione dei problemi
DataPower mancante Tracciamento delle chiamate nell'interfaccia utente di Instana
Se le chiamate di tracciamento dell' DataPower e non vengono visualizzate nell'interfaccia utente di Instana come previsto, procedere come segue:
- Abilita il debug per il tracciamento di Instana DataPower :
- Accedere al pod DataPower e andare alla directory
/app/libsnel contenitorejaeger-tracing-agent. - Modificare il file
logback.xmlmodificando<root level="info">in<root level="debug">. La modifica diventa effettiva in un minuto.
- Accedere al pod DataPower e andare alla directory
- Utilizza il
oc logs <datapower-pod-name> -c jaeger-tracing-agentcomando per raccogliere le informazioni di debug dell'agente di tracciamento Instana DataPower.