Gestione dei raccoglitori dati

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Una risorsa di raccoglitore dati consente di raccogliere un'ampia gamma di dati personalizzati dal traffico API. Dopo aver creato un raccoglitore dati, puoi specificare i dati da raccogliere utilizzando il criterio DataCapture. Il raccoglitore dati è come un carrello degli acquisti e il criterio Data Capture è una lista della spesa per i dati che vuoi acquisire.

Nota: se utilizzi un raccoglitore dati in più criteri, i dati acquisiti verranno sovrascritti dall'ultimo criterio eseguito.

Per un elenco delle quantità relative al traffico delle API che puoi acquisire utilizzando la risorsa del raccoglitore dati, consulta Metriche.

Creazione di un raccoglitore dati

Puoi creare una risorsa di raccoglitore dati nell'interfaccia utente di Apigee o con l'API Apigee:

Nota: è disponibile una nuova versione dell'interfaccia utente di Apigee, integrata con la console Google Cloud. La nuova UI si chiama Apigee nella console Cloud. Le istruzioni nelle prime due schede di seguito spiegano come utilizzare Apigee nella console Cloud o Apigee versione classica.

Apigee nella console Cloud

Per creare una risorsa raccoglitore dati utilizzando Apigee nella console Cloud:

1. Apri https://console.cloud.google.com/apigee in un browser.
2. Seleziona Gestione > Raccoglitori dati nel riquadro di navigazione.
3. Nella vista Raccoglitori dati, fai clic su Crea.
4. Fai clic su + Crea per visualizzare la finestra di dialogo Aggiungi raccoglitore dati.
5. Aggiungi le seguenti informazioni nella finestra di dialogo:
   • Nome: il nome del raccoglitore dati.
     Nota: il nome di un raccoglitore dati deve iniziare con dc_.
     Avviso:non creare due raccoglitori dati i cui nomi differiscono solo per l'uso delle maiuscole, ad esempio dc_my_data e dc_My_Data, perché l'esportazione dei dati genererà un errore di tipo "nomi di colonna duplicati".
   • Tipo: il tipo di dati da raccogliere (Integer, String e così via).
   • Descrizione: una descrizione informale dei dati da raccogliere, che potrebbe includere il motivo della raccolta. Ciò è a vantaggio di altri sviluppatori di API che potrebbero essere coinvolti nell'analisi dei dati.
6. Fai clic su AGGIUNGI.

Versione classica di Apigee

Per creare una risorsa raccoglitore dati utilizzando la versione classica di Apigee:

1. Apri l'UI di Apigee in un browser.

2. Seleziona Amministrazione > Raccoglitori dati nel riquadro di navigazione.

   

   Viene visualizzato il riquadro Raccoglitori dati.

   

   Il riquadro mostrato sopra è vuoto perché non sono stati ancora creati raccoglitori dati. A questo punto, puoi creare un nuovo raccoglitore dati. Una volta creati alcuni raccoglitori dati, puoi fare clic sui rispettivi nomi nel riquadro per modificarli.

3. Fai clic su + CREA per visualizzare la finestra di dialogo Aggiungi raccoglitore dati.

   
4. Aggiungi le seguenti informazioni nella finestra di dialogo:
   • Nome: il nome del raccoglitore dati.
     Nota: il nome di un raccoglitore dati deve iniziare con dc_.
     Nota: non creare due raccoglitori dati i cui nomi differiscono solo per l'uso delle maiuscole, ad esempio dc_my_data e dc_My_Data, perché l'esportazione dei dati genererà un errore di tipo "nomi di colonna duplicati".
   • Tipo: il tipo di dati da raccogliere (Integer, String e così via).
   • Descrizione: una descrizione informale dei dati da raccogliere, che potrebbe includere il motivo della raccolta. Ciò è a vantaggio di altri sviluppatori di API che potrebbero essere coinvolti nell'analisi dei dati.
5. Fai clic su AGGIUNGI.

Il nuovo raccoglitore dati viene ora visualizzato nel riquadro Raccoglitore dati.

Per modificare o eliminare un raccoglitore dati, fai clic sui tre puntini alla fine della riga corrispondente in Azioni e seleziona Modifica o Elimina.

API Apigee

Puoi creare una risorsa del raccoglitore dati utilizzando l'API Apigee. Ad esempio:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -X POST -H "content-type:application/json" \
  -d '
{
  "name": "dc_data_collector",
  "description": "Collects data for analysis.",
  "type": "STRING",
}' \
  "https://apigee.googleapis.com/v1/organizations/ORG/datacollectors"

dove ORG è il nome dell'organizzazione. Viene creata una risorsa denominata dc_data_collector, che puoi utilizzare nel criterio DataCapture.

Note:

• Il nome della risorsa raccoglitore dati deve iniziare con il prefisso dc_.
• Se utilizzi un raccoglitore dati in più criteri Data Capture, i dati acquisiti verranno sovrascritti dall'ultimo criterio eseguito.

Avviso: non creare due raccoglitori dati i cui nomi differiscono solo per caso, ad esempio dc_my_data e dc_My_Data, dato che l'esportazione dei dati genererà un errore di tipo "nomi di colonna duplicati".