Questa pagina si applica ad Apigee, ma non ad Apigee hybrid.
Visualizza la documentazione di
Apigee Edge.
Apigee API Analytics raccoglie e calcola una grande quantità di informazioni che fluiscono attraverso i proxy API. Puoi visualizzare questi dati con grafici nell'interfaccia utente di Apigee oppure puoi 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 a pagamento. 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 dei dashboard di Apigee API Analytics dopo l'attivazione del componente aggiuntivo negli ambienti Apigee, consulta Utilizzo dei dashboard di analisi.
Disponibilità
Apigee API Analytics è disponibile come funzionalità aggiuntiva a pagamento gestita per ogni ambiente Apigee nella tua implementazione di Apigee. Il componente aggiuntivo può essere abilitato in qualsiasi ambiente Intermedio o Completo di Apigee. Non puoi abilitare e utilizzare Apigee API Analytics negli ambienti Base. Per maggiori dettagli sulle funzionalità dell'ambiente Apigee, vedi Confronto tra i 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 ambiente Apigee (apigee.environment.admin) nel progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene le autorizzazioni necessarie per gestire il componente aggiuntivo Apigee API Analytics. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per gestire il componente aggiuntivo Apigee API Analytics sono necessarie le seguenti autorizzazioni:
-
apigee.addonsconfig.get -
apigee.addonsconfig.update
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Abilitare il componente aggiuntivo Apigee API Analytics
Puoi abilitare il componente aggiuntivo Apigee API Analytics per un ambiente Apigee intermedio o completo utilizzando l'interfaccia utente Apigee nella console Google Cloud o l'API, come descritto nelle sezioni seguenti.
Apigee nella console Google Cloud
Per attivare il componente aggiuntivo Apigee API Analytics nella console Google Cloud :
- Apri la pagina Apigee nella console.
- Seleziona il progetto con l'organizzazione e gli ambienti con pagamento a consumo che vuoi gestire.
- Seleziona Componenti aggiuntivi > Analytics per aprire la pagina del componente aggiuntivo Analytics.
- Nel riquadro Gestisci componente aggiuntivo Apigee API Analytics, seleziona la casella di controllo per l'ambiente o gli ambienti in cui vuoi attivare il componente aggiuntivo.
- Fai clic su Attiva selezionati.
- Al termine dell'attivazione per gli ambienti selezionati, lo stato dell'ambiente mostrerà Attivato.
- Per visualizzare i dati di Apigee API Analytics, seleziona Analytics > Metriche API per visualizzare i dati di analisi. Potrebbero essere necessari fino a 10 minuti prima che i dati di analisi vengano visualizzati.
API Apigee
Per abilitare il componente aggiuntivo Apigee API Analytics utilizzando l'API Apigee, inserisci il seguente comando:
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}'Dove:
- ORG_NAME è il nome dell'organizzazione Apigee Pay-as-you-go a cui vuoi aggiungere Analytics agli ambienti idonei.
- ENV_NAME è il nome dell'ambiente Apigee in cui vuoi abilitare il componente aggiuntivo Apigee API Analytics.
Una volta completata l'attivazione, seleziona Analytics > Metriche API per visualizzare i dati di Apigee API Analytics. Potrebbero essere necessari fino a 10 minuti prima che i dati di analisi vengano visualizzati nell'interfaccia utente o siano disponibili tramite una chiamata API.
La procedura di attivazione del componente aggiuntivo Apigee API Analytics può richiedere fino a 15 minuti. Una volta abilitati, i dati di analisi per l'ambiente vengono conservati per 14 mesi. Puoi accedere ai dati storici dell'ambiente dalla pagina Metriche API nella console finché il componente aggiuntivo è abilitato.
La fatturazione per l'utilizzo del componente aggiuntivo Apigee API Analytics inizia una volta avviata 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 l'interfaccia utente Apigee nella console Google Cloud o l'API, come descritto nelle sezioni seguenti.
Se il componente aggiuntivo Advanced API Security è abilitato nell'ambiente, devi disabilitarlo prima di poter disabilitare 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, verrà visualizzato nella colonna Altri componenti aggiuntivi abilitati del riquadro Gestisci componente aggiuntivo Apigee API Analytics.
Per disattivare il componente aggiuntivo, vedi Disattivare il componente aggiuntivo Advanced API Security.
Apigee nella console Cloud
Per disattivare il componente aggiuntivo Apigee API Analytics nella console Google Cloud :
- Apri la pagina Apigee nella console.
- Seleziona il progetto con l'organizzazione e gli ambienti con pagamento a consumo che vuoi gestire.
- Seleziona Componenti aggiuntivi > Analytics per aprire la pagina del componente aggiuntivo Analytics.
- Nel riquadro Gestisci componente aggiuntivo Apigee API Analytics, seleziona la casella di controllo per l'ambiente o gli ambienti in cui vuoi disattivare il componente aggiuntivo.
- Fai clic su Disattiva selezionati.
- Al termine della disattivazione, nella colonna Stato verrà visualizzato Disattivato per ogni ambiente.
API Apigee
Per disattivare il componente aggiuntivo Apigee API Analytics utilizzando l'API Apigee, inserisci il seguente comando:
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}'Dove:
- ORG_NAME è il nome dell'organizzazione Apigee Pay-as-you-go a cui vuoi aggiungere Analytics agli ambienti idonei.
- ENV_NAME è il nome dell'ambiente Apigee in cui vuoi abilitare il componente aggiuntivo Apigee API Analytics.
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.
Apigee nella console Google Cloud
Per visualizzare lo stato del componente aggiuntivo Apigee API Analytics in un ambiente utilizzando la console Google Cloud :
- Apri la pagina Apigee nella console.
- Seleziona il progetto con l'organizzazione e gli ambienti con pagamento a consumo che vuoi gestire.
- Seleziona Componenti aggiuntivi > Analytics per aprire la pagina del componente aggiuntivo Analytics.
- Nel riquadro Gestisci componente aggiuntivo Apigee API Analytics viene visualizzato un elenco di ambienti.
- Nella colonna Stato puoi vedere se il componente aggiuntivo è Attivato o Disattivato in ogni ambiente intermedio o completo. Gli ambienti di base non mostrano nessuno dei due stati.
API Apigee
Per visualizzare lo stato del componente aggiuntivo Apigee API Analytics in un ambiente utilizzando l'API Apigee, inserisci il seguente comando:
curl -X GET \
https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME/addonsConfig \
-H "Authorization: Bearer $token" \
-H "Content-type: application/json" Dove:
- ORG_NAME è il nome dell'organizzazione Apigee con pagamento a consumo.
- ENV_NAME è il nome dell'ambiente Apigee.
La risposta restituisce un oggetto analyticsConfig che rappresenta lo stato attuale del componente aggiuntivo.
Gestire i dati di Apigee API Analytics
Una volta abilitato 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 storici di analisi dell'ambiente dalla pagina Metriche API nella console finché il componente aggiuntivo è 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 riaccedere ai dati di analisi per l'ambiente durante il periodo di conservazione di 14 mesi. Se il componente aggiuntivo viene riattivato per l'ambiente dopo 30 giorni, non vengono ripristinati dati.
Se vuoi conservare i dati di analisi per qualsiasi ambiente oltre il periodo di conservazione di 14 mesi, ti consigliamo di esportarli e salvarli in un'altra posizione. Ti consigliamo inoltre di esportare i dati di Analytics prima di disattivare il componente aggiuntivo Apigee API Analytics o entro 30 giorni dalla disattivazione. Per ulteriori informazioni, consulta Esportare i dati da Analytics.