Gestire il componente aggiuntivo Apigee API Analytics

Questa pagina si applica ad Apigee, ma non ad Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Apigee API Analytics raccoglie e calcola una vasta gamma di informazioni che passano attraverso i proxy API. Puoi visualizzare questi dati con grafici e diagrammi nell'interfaccia utente di Apigee oppure scaricare i dati non elaborati per l'analisi offline utilizzando le API Apigee. Per saperne di più sui tipi di dati che puoi raccogliere e analizzare con Apigee API Analytics, consulta la panoramica di Apigee Analytics.

Se sei un cliente Apigee con pagamento a consumo, Apigee API Analytics è disponibile come componente aggiuntivo pagato. Questo argomento descrive come attivare e gestire il componente aggiuntivo Apigee API Analytics per gli ambienti Pay-as-you-go idonei. Per saperne di più sull'utilizzo delle dashboard di Analytics dell'API Apigee dopo l'attivazione del componente aggiuntivo negli ambienti Apigee, consulta Utilizzare le dashboard di analisi.

Disponibilità

Apigee API Analytics è disponibile come funzionalità aggiuntiva a pagamento gestita per ogni ambiente Apigee nell'implementazione di Apigee. Il componente aggiuntivo può essere attivato in qualsiasi ambiente Apigee Intermedio o Completo. Non puoi attivare e utilizzare Apigee API Analytics negli ambienti Base. Per maggiori dettagli sulle funzionalità degli ambienti Apigee, consulta Confronto dei tipi di ambiente.

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per gestire il componente aggiuntivo Apigee API Analytics, chiedi all'amministratore di concederti il ruolo IAM Amministratore dell'ambiente Apigee (apigee.environment.admin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per gestire il componente aggiuntivo Apigee API Analytics. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Attiva il componente aggiuntivo Apigee API Analytics

Puoi attivare il componente aggiuntivo Apigee API Analytics per un ambiente Apigee Intermedio o Comprensivo utilizzando la UI di Apigee nella console Google Cloud o l'API, come descritto nelle sezioni seguenti.

curl -X POST \
  https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME/addonsConfig:setAddonEnablement \
      -H "Authorization: Bearer $token" \
      -H "Content-type: application/json" \
      -d '{"analyticsEnabled":true}'

La procedura di attivazione del componente aggiuntivo Apigee API Analytics può richiedere fino a 15 minuti. Una volta attivata, la conservazione dei dati di analisi per l'ambiente viene applicata per 14 mesi. Puoi accedere ai dati storici dell'ambiente dalla pagina Metriche API della console, a condizione che il componente aggiuntivo sia abilitato.

La fatturazione per l'utilizzo del componente aggiuntivo Apigee API Analytics inizia con l'attivazione del componente aggiuntivo.

Disattivare il componente aggiuntivo Apigee API Analytics

Puoi disattivare il componente aggiuntivo Apigee API Analytics per un ambiente Apigee Intermedio o Completo utilizzando la UI di Apigee nella console Google Cloud o l'API, come descritto nelle sezioni seguenti.

Se hai attivato il componente aggiuntivo Advanced API Security nell'ambiente, devi disattivarlo prima di poter disattivare il componente aggiuntivo Apigee API Analytics. Se il componente aggiuntivo Advanced API Security non è disattivato, qualsiasi richiesta di disattivazione di Apigee API Analytics nell'ambiente non andrà a buon fine. Se il componente aggiuntivo Advanced API Security è abilitato nel tuo ambiente, viene visualizzato nella colonna Altri componenti aggiuntivi abilitati del riquadro Gestisci il componente aggiuntivo Apigee API Analytics.

Per disattivare il componente aggiuntivo, consulta Disattivare il componente aggiuntivo Advanced API Security.

curl -X POST \
  https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME/addonsConfig:setAddonEnablement \
      -H "Authorization: Bearer $token" \
      -H "Content-type: application/json" \
      -d '{"analyticsEnabled":false}'

Visualizzare lo stato del componente aggiuntivo Apigee API Analytics in un ambiente

Puoi controllare lo stato del componente aggiuntivo Apigee API Analytics per un ambiente Apigee Intermedio o Completo utilizzando la UI di Apigee nella console Google Cloud o l'API, come descritto nelle sezioni seguenti.

curl -X GET \
  https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME/addonsConfig \
      -H "Authorization: Bearer $token" \
      -H "Content-type: application/json" 

Gestire i dati di Apigee API Analytics

Una volta attivato il componente aggiuntivo Apigee API Analytics per un ambiente, i dati di analisi per l'ambiente vengono conservati per 14 mesi. Puoi accedere ai dati di analisi storici dell'ambiente dalla pagina Metriche API nella console, a condizione che il componente aggiuntivo sia abilitato.

Se disattivi il componente aggiuntivo Apigee API Analytics in un ambiente, i dati di analisi per l'ambiente vengono eliminati dopo 30 giorni. Se riattivi il componente aggiuntivo nello stesso ambiente entro 30 giorni dalla disattivazione, puoi riottenere l'accesso ai dati di analisi per l'ambiente durante il periodo di conservazione di 14 mesi. Nessun dato viene ripristinato se il componente aggiuntivo viene riattivato per l'ambiente dopo 30 giorni.

Se vuoi conservare i dati di analisi per qualsiasi ambiente oltre il periodo di conservazione di 14 mesi, ti consigliamo di esportare e salvare i dati in un'altra posizione. Ti consigliamo inoltre di esportare i dati di Analytics prima di disattivare il componente aggiuntivo Apigee API Analytics o entro il periodo di 30 giorni successivo alla disattivazione. Per ulteriori informazioni, consulta Esportare i dati da Analytics.