Daten-Collectors verwalten

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Mit einer Daten-Collector-Ressource können Sie eine Vielzahl von benutzerdefinierten Daten vom API-Traffic erfassen. Nachdem Sie einen Daten-Collector erstellt haben, geben Sie die zu erfassenden Daten mithilfe der DataCapture-Richtlinie an. Der Daten-Collector ist wie ein Einkaufswagen. Die DataCapture-Richtlinie ist eine Einkaufsliste für die Daten, die Sie erfassen möchten.

Hinweis: Wenn Sie einen Daten-Collector in mehreren Richtlinien verwenden, werden die erfassten Daten mit der letzten ausgeführten Richtlinie überschrieben.

Eine Liste der Mengenangaben im Zusammenhang mit dem API-Traffic, den Sie mit der Data Collector-Ressource erfassen können, finden Sie unter Messwerte.

Daten-Collector erstellen

Sie können eine Datenerfassungsressource in der Apigee-Benutzeroberfläche oder mit der Apigee API erstellen:

Hinweis: Es gibt eine neue Version der Apigee-UI, die in die Google Cloud Console eingebunden ist. Die neue Benutzeroberfläche heißt Apigee in der Cloud Console. In den Anleitungen auf den ersten beiden Tabs unten wird erläutert, wie Sie Apigee in der Cloud Console oder das klassische Apigee verwenden.

Apigee in der Cloud Console

So erstellen Sie eine Daten-Collector-Ressource mit Apigee in der Cloud Console:

1. Öffnen Sie https://console.cloud.google.com/apigee in einem Browser.
2. Wählen Sie im Navigationsbereich Management > Daten-Collectors aus.
3. Klicken Sie in der Ansicht Daten-Collectors auf Erstellen.
4. Klicken Sie auf + Erstellen, um das Dialogfeld Daten-Collector hinzufügen aufzurufen.
5. Geben Sie im Dialogfeld die folgenden Informationen ein:
   • Name: Ein Name für den Daten-Collector.
     Hinweis: Der Name für einen Daten-Collector muss mit dc_ beginnen.
     Warnung: Erstellen Sie keine zwei Daten-Collectors, deren Namen sich nur in der Groß- und Kleinschreibung unterscheiden, wie z. B. dc_my_data und dc_My_Data, weil sonst der Datenexport zum Fehler "Doppelte Spaltennamen" führt.
   • Typ: Der Typ der zu erfassenden Daten (Integer, String usw.).
   • Beschreibung: Informelle Beschreibung der zu erfassenden Daten, einschließlich des Grunds für die Erfassung. Das dient den anderen API-Entwicklern, die möglicherweise an der Datenanalyse beteiligt sind.
6. Klicken Sie auf HINZUFÜGEN.

Klassisches Apigee

So erstellen Sie eine Data Collector-Ressource über das klassische Apigee:

1. Öffnen Sie die Apigee-Benutzeroberfläche in einem Browser.

2. Wählen Sie im Navigationsbereich Admin > Daten-Collectors aus.

   

   Daraufhin wird der Bereich "Daten-Collectors" angezeigt.

   

   Der oben angezeigte Bereich ist leer, da noch keine Daten-Collectors erstellt wurden. An diesem Punkt können Sie einen neuen Daten-Collector erstellen. Nachdem einige Daten-Collectors erstellt wurden, können Sie auf ihre Namen im Fenster klicken, um sie zu bearbeiten.

3. Klicken Sie auf + ERSTELLEN, um das Dialogfeld Daten-Collector hinzufügen aufzurufen.

   
4. Geben Sie im Dialogfeld die folgenden Informationen ein:
   • Name: Ein Name für den Daten-Collector.
     Hinweis: Der Name für einen Daten-Collector muss mit dc_ beginnen.
     Hinweis: Erstellen Sie nicht zwei Daten-Collectors, deren Namen sich nur in Groß- und Kleinschreibung unterscheiden, wie z. B. dc_my_data und dc_My_Data, weil sonst der Datenexport zum Fehler "Doppelte Spaltennamen" führt.
   • Typ: Der Typ der zu erfassenden Daten (Integer, String usw.).
   • Beschreibung: Informelle Beschreibung der zu erfassenden Daten, einschließlich des Grunds für die Erfassung. Das dient den anderen API-Entwicklern, die möglicherweise an der Datenanalyse beteiligt sind.
5. Klicken Sie auf HINZUFÜGEN.

Der neue Daten-Collector wird nun im Bereich "Daten-Collectors" angezeigt.

Klicken Sie zum Bearbeiten oder Löschen eines Daten-Collectors auf das Dreipunkt-Menü am Ende der Zeile unter Aktionen und wählen Sie entweder Bearbeiten oder Löschen auf Ihrem Mobilgerät.

Apigee API

Sie können eine Data Collector-Ressource mithilfe der Apigee API erstellen. Beispiel:

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"

Dabei ist ORG der Name der Organisation. Dadurch wird eine Ressource mit dem Namen dc_data_collector erstellt, die Sie in der Richtlinie DataCapture verwenden können.

Hinweise:

• Der Name der Data Collector-Ressource muss mit dem Präfix dc_ beginnen.
• Wenn Sie einen Data Collector in mehreren DataCapture-Richtlinien verwenden, werden die erfassten Daten mit der letzten ausgeführten Richtlinie überschrieben.

Warnung: Erstellen Sie keine zwei Daten-Collectors, deren Namen sich nur durch Großschreibung wie dc_my_data und dc_My_Data unterscheiden, weil sonst der Datenexport zum Fehler "Doppelte Spaltennamen" führt.