Gestione dei raccoglitori di dati

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Una risorsa di collezionista di dati ti consente di raccogliere una vasta gamma di dati personalizzati dal traffico dell'API. Dopo aver creato un raccoglitore di dati, specifica i dati che vuoi raccogliere utilizzando il criterio DataCapture. Il raccoglitore di dati è come un carrello degli acquisti e il criterio DataCapture è una lista della spesa per i dati che vuoi acquisire.

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

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

Creazione di un raccoglitore di dati

Puoi creare una risorsa del raccoglitore di 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 riportate di seguito spiegano come utilizzare Apigee in Cloud Console o Apigee classico.

Apigee nella console Cloud

Per creare una risorsa di raccolta dei dati utilizzando Apigee nella console Cloud:

1. Apri la UI di Apigee nella console Cloud in un browser.
2. Seleziona Gestione > Raccogli dati nel riquadro di navigazione.
3. Nella visualizzazione Raccoglitori di dati, fai clic su Crea.
4. Fai clic su + Crea per visualizzare la finestra di dialogo Aggiungi raccoglitore di dati.
5. Aggiungi le seguenti informazioni nella finestra di dialogo:
   • Nome: un nome per il raccoglitore di dati.
     Nota: il nome di un raccoglitore di dati deve iniziare con dc_.
     Avviso: non creare due collezioni di 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 comporterà un errore di "nomi di colonne duplicati".
   • Tipo: il tipo di dati da raccogliere (Integer, String e così via).
   • Descrizione: una descrizione informale dei dati da raccogliere, che può includere il motivo della raccolta. Questo è a vantaggio di altri sviluppatori di API che potrebbero essere coinvolti nell'analisi dei dati.
6. Fai clic su AGGIUNGI.

Apigee classica

Per creare una risorsa del raccoglitore dati utilizzando Apigee Classic:

1. Apri la UI di Apigee in un browser.

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

   

   Viene visualizzato il riquadro Raccoglitori di dati.

   

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

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

   
4. Aggiungi le seguenti informazioni nella finestra di dialogo:
   • Nome: un nome per il raccoglitore di dati.
     Nota: il nome di un raccoglitore di dati deve iniziare con dc_.
     Nota: non creare due collezioni di 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 comporterà un errore di "nomi di colonne duplicati".
   • Tipo: il tipo di dati da raccogliere (Integer, String e così via).
   • Descrizione: una descrizione informale dei dati da raccogliere, che può includere il motivo della raccolta. Questo è a vantaggio degli altri sviluppatori di API che potrebbero essere coinvolti nell'analisi dei dati.
5. Fai clic su AGGIUNGI.

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

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

API Apigee

Puoi creare una risorsa Raccogli 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 del raccoglitore dei dati deve iniziare con il prefissodc_.
• Se utilizzi un raccoglitore di dati in più criteri DataCapture, i dati acquisiti verranno sovrascritti dall'ultimo criterio eseguito.

Avviso: non creare due collezioni di 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 comporterà un errore di "nomi di colonne duplicati".