Raccolta dei dati di debug, analisi e stato del deployment

Attualmente, stai visualizzando la versione 1.5 della documentazione ibrida Apigee. Per ulteriori informazioni, consulta la sezione Versioni supportate.

Apigee ibrido mette a tua disposizione i dati di stato di debug, analisi e deployment. Questi dati vengono raccolti da un pod di raccolta dati che li invia al piano di gestione per consentirti di visualizzarli e analizzarli e impostare monitoraggio e avvisi.

Informazioni sui dati

Tutti i servizi di elaborazione dei messaggi (MP) nel debug ibrido del flusso (se avviato), nei dati di analisi e nello stato del deployment tramite TCP in un pod di raccolta dati nel cluster. Il pod di raccolta dati archivia i dati in streaming sul file system del pod tramite un servizio fluent.

L'UDCA (Universal Data Collection Agent) estrae periodicamente i dati archiviati e li invia al servizio UAP (Unified Analytics Platform) nel piano di gestione. L'UPA elabora i dati in entrata relativi all'analisi e al deployment e li rende disponibili tramite l'interfaccia utente ibrida o le API Apigee.

Apigee ibrido implementa il pod di raccolta dati come un ReplicaSet con un minimo di due repliche.

L'immagine seguente mostra il processo di raccolta dei dati di debug, analisi e stato del deployment:

Tieni presente che i dati di stato di debug, analisi e deployment non vengono archiviati nella stessa località o non sono accessibili come i dati di logging e metriche:

• I dati di logging e metriche vengono archiviati nel progetto GCP e sono accessibili tramite uno strumento come Cloud Operations o qualsiasi altro prodotto che scegli di utilizzare.
• I dati di debug, analisi e stato del deployment, invece, vengono archiviati nel piano di gestione ibrida e vi si accede tramite servizi Apigee come l'interfaccia utente ibrida o le API Apigee.

La tabella seguente riassume i dati raccolti dal pod di raccolta dati:

Tipo di dati	Nome set di dati	Descrizione	Frequenza di aggiornamento	API
Analisi	api	Dati di utilizzo dell'API, che includono transazioni al secondo, utilizzo della cache, errori, latenze, dimensioni di richiesta/risposta e conteggio del traffico. Per ulteriori informazioni, consulta la panoramica di Apigee Analytics.	Fino a 30 secondi di ritardo	API Analytics per amministratori
Stato di deployment	event	Lo stato attuale del deployment del proxy API. Per maggiori informazioni su come visualizzare queste informazioni, consulta la sezione Visualizzare lo stato del deployment.	Immediatamente	API Deployments
Debugger	debug	Eseguire il debug dei dati di sessione per i proxy API. Questi dati includono i parametri per la richiesta e la risposta e le trasformazioni applicate al momento dell'esecuzione del criterio. A causa delle sue dimensioni, i dati di debug, a differenza dei dati di analisi e di stato del deployment, non vengono raccolti sempre. I dati di debug vengono invece raccolti quando avvii una sessione di debug. Per ulteriori informazioni, consulta la panoramica del debug.	Immediatamente	API Sessione di debug API dei dati della sessione di debug

SUGGERIMENTO: il nome del set di dati è il nome con cui si fa riferimento a questo tipo di dati nelle proprietà di configurazione UDCA. Ad esempio, i dati di analisi vengono configurati con il nome del set di dati api. Di conseguenza, la proprietà di configurazione che imposta la posizione dei file di dati di analisi si chiama apiDataSubDir.

Puoi accedere a questi dati tramite l'interfaccia utente ibrida di Apigee o le API Apigee sul piano di gestione.

Visualizzare i dati nell'interfaccia utente ibrida

Questa sezione descrive come visualizzare i dati di stato del debug, dell'analisi e del deployment nell'interfaccia utente ibrida di Apigee.

Debugger

I dati di debug per i servizi ibridi sono accessibili allo stesso modo dei dati di debug Edge, con alcune differenze come il supporto del filtro migliorato. Per ulteriori informazioni, consulta la sezione Panoramica del debug.

Analisi

I dati di analisi per i servizi ibridi sono accessibili allo stesso modo dei dati di Edge Analytics. Per ulteriori informazioni, consulta Utilizzo delle dashboard di analisi nella documentazione di Edge.

Stato di deployment proxy

Per informazioni sulla visualizzazione dello stato della distribuzione, consulta Visualizzazione dello stato della distribuzione.

Configurare la raccolta dati

Per impostare come e dove vengono raccolti i dati di stato di debug, analisi e deployment nel pod di raccolta dati, devi configurare il servizio UDCA tramite le relative proprietà di configurazione. Le proprietà UDCA includono proprietà generali per l'UDCA e proprietà specifiche per ogni set di dati.

Per configurare l'UDCA:

1. Apri il file overrides.yaml per la modifica sul computer di amministrazione Kubernetes, come descritto in Gestire i componenti del piano di runtime.
2. Imposta i valori delle impostazioni di configurazione dell'UDCA. Per la funzionalità UDCA, puoi impostare valori personalizzati per le proprietà, ad esempio:
   • Intervallo di polling
   • Numero di repliche (min e max)
   • Percentuale CPU target (che attiva repliche aggiuntive)

   Per un elenco completo delle proprietà UDCA che puoi personalizzare, consulta la sezione udca.

3. Salva le modifiche apportate al file override.yaml.
4. Applica le modifiche al cluster eseguendo il comando apigeectl apply, come illustrato nell'esempio seguente:

   apigeectl apply -f my-overrides.yaml --org --env env-name

   SUGGERIMENTO: per visualizzare le proprietà di configurazione predefinite, il servizio UDCA (sotto udca:) nel riferimento proprietà della configurazione.

   Per maggiori informazioni sul comando apply, consulta Applicare un modello ibrido al cluster.