Gestione dei raccoglitori di dati

Questa pagina si applica a Apigee e Apigee ibridi.

Visualizza documentazione di Apigee Edge.

R raccoglitore dati consente di raccogliere un'ampia varietà di dati personalizzati dal traffico 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 dati

Puoi creare una risorsa di raccolta dati nella UI 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. La le istruzioni nelle prime due schede spiegano come utilizzare Apigee nella console Cloud o nella versione classica di Apigee.

Apigee nella console Cloud

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

1. Apri l'UI di Apigee nella console Cloud in un browser.
2. Seleziona Gestione > Raccoglitori 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 per un raccoglitore 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.

Versione classica di Apigee

Per creare una risorsa del raccoglitore dati utilizzando Apigee Classic:

1. Apri la UI di Apigee in un browser.

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

   

   Viene visualizzato il riquadro Raccoglitori di dati.

   

   Il riquadro mostrato sopra è vuoto perché non è ancora stato creato alcun raccoglitore 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 per un raccoglitore dati deve iniziare con dc_.
     Nota: non creare due raccoglitori dati con nomi diversi solo per caso, ad esempio dc_my_data e dc_My_Data, quindi l'esportazione generano "nomi di colonna duplicati" .
   • Tipo: il tipo di dati da raccogliere (Integer, String e così via).
   • Descrizione: una descrizione informale dei dati da raccogliere, possibilmente incluso il motivo della raccolta. Ciò a vantaggio di altri sviluppatori di API potenzialmente 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 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 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 con nomi diversi solo per caso, ad esempio dc_my_data e dc_My_Data, quindi l'esportazione generano "nomi di colonna duplicati" .