Apigee Hybrid stellt Debugging-, Analyse- und Bereitstellungsstatusdaten zur Verfügung. Diese Daten werden von einem Datenerhebungs-Pod erhoben und an die Verwaltungsebene gesendet. So können Sie die Daten anzeigen und analysieren sowie Monitoring und Benachrichtigungen einrichten.
Über die Daten
Alle MP-Dienste (Message Processor) in Hybrid streamen Debugging- (falls initiiert), Analyse- und Bereitstellungsstatusdaten über TCP an einen Datenerhebungs-Pod im Cluster. Der Datenerhebungs-Pod speichert die gestreamten Daten über einen fluentd-Dienst im Dateisystem des Pods.
Der UDCA (Universal Data Collection Agent) extrahiert die gespeicherten Daten regelmäßig und sendet sie auf der Verwaltungsebene an den UAP-Dienst (Unified Analytics Platform). Der UAP verarbeitet die eingehenden Analyse- und Bereitstellungsstatusdaten und stellt sie Ihnen über die Hybrid-Benutzeroberfläche oder die Apigee APIs zur Verfügung.
Apigee Hybrid implementiert den Datenerhebungs-Pod als ReplicaSet mit mindestens zwei Replikaten.
Die folgende Abbildung demonstriert die Erhebung der Debugging-, Analyse- und Bereitstellungsstatusdaten:
Die Debugging-, Analyse- und Bereitstellungsstatusdaten werden nicht am selben Ort gespeichert und nicht auf dieselbe Art wie Logging- und Messwertdaten abgerufen:
Logging- und Messwertdaten werden in Ihrem Google Cloud-Projekt gespeichert und über ein Tool wie Cloud Operations oder einem anderen Tool Ihrer Wahl aufgerufen.
Debugging-, Analyse- und Bereitstellungsstatusdaten werden andererseits in der Hybrid-Verwaltungsebene gespeichert und über Apigee-Dienste wie die Hybrid-UI oder Apigee-APIs abgerufen.
Folgende Tabelle fasst die vom Datenerhebungs-Pod erfassten Daten zusammen:
Datentyp
Dataset-Name
Beschreibung
Aktualisierungsrate
APIs
Analysen
api
API-Nutzungsdaten, einschließlich Transaktionen pro Sekunde, Cache-Nutzung, Fehler, Latenzen, Anfrage-/Antwortgrößen und Trafficzahlen.
Debuggen Sie Sitzungsdaten für API-Proxys. Dazu gehören die Anfrage-/Antwortparameter sowie die Transformationen, die während der Richtlinienausführung angewendet werden.
Aufgrund der Größe werden Debugging-Daten im Gegensatz zu Analyse- und Bereitstellungsstatusdaten nicht immer erhoben. Debugging-Daten werden dann erhoben, wenn Sie eine Debugging-Sitzung starten.
In diesem Abschnitt wird beschrieben, wie Sie die Debugging-, Analyse- und Bereitstellungsstatusdaten in der Apigee Hybrid-Benutzeroberfläche ansehen.
Fehlerbehebung
Auf Debugging-Daten für Hybriddienste kann auf dieselbe Weise zugegriffen werden wie auf Edge-Debugging-Daten. Es gibt aber einige Unterschiede, z. B. eine erweiterte Filterunterstützung. Weitere Informationen finden Sie unter Debugging.
Analysen
Analytics-Daten für Hybriddienste sind auf dieselbe Weise zugänglich wie Edge-Analysedaten. Weitere Informationen finden Sie unter Verwendung der Analyse-Dashboards in der Edge-Dokumentation.
Zum Festlegen, wie und wo Debugging-, Analyse- und Bereitstellungsstatusdaten im Datenerhebungs-Pod erhoben werden, konfigurieren Sie den UDCA über die Konfigurationsattribute. Die UDCA-Attribute umfassen allgemeine Attribute und auch Dataset-spezifische Attribute.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-18 (UTC)."],[[["\u003cp\u003eApigee hybrid collects debug, analytics, and deployment status data from Message Processor (MP) services, which is then streamed to a data collection pod.\u003c/p\u003e\n"],["\u003cp\u003eThe Universal Data Collection Agent (UDCA) periodically extracts this data from the pod and sends it to the Unified Analytics Platform (UAP) in the management plane, where it can be accessed.\u003c/p\u003e\n"],["\u003cp\u003eData such as API usage, deployment status, and debug session details are accessible via the Apigee hybrid UI or through Apigee APIs.\u003c/p\u003e\n"],["\u003cp\u003eLogging and metrics data are stored on the user's Google Cloud Project, while debug, analytics, and deployment status data are stored in the hybrid management plane and accessed via Apigee services.\u003c/p\u003e\n"],["\u003cp\u003eThe UDCA service can be configured through the \u003ccode\u003eoverrides.yaml\u003c/code\u003e file, allowing customization of properties like polling interval and the number of replicas for data collection.\u003c/p\u003e\n"]]],[],null,["# Debug, analytics, and deployment status data collection\n\n| You are currently viewing version 1.14 of the Apigee hybrid documentation. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\nApigee hybrid makes debug, analytics, and deployment status data available to you. This data is\ncollected by a data collection pod which sends it to the management plane so that you can view and\nanalyze it and set up monitoring and alerts.\n\nAbout the data\n--------------\n\nAll Message Processor (MP) services in hybrid stream debug (when initiated), analytics,\nand deployment status data via\nTCP to a data collection pod in the cluster. The data collection pod stores the streamed data on the\npod's file system via a fluentd service.\n\nThe UDCA (Universal Data Collection Agent) periodically extracts the stored data and sends it to\nthe UAP (Unified Analytics Platform) service in the management plane. The UAP processes the incoming\nanalytics and deployment status data and makes it available to you via the hybrid UI or the\n[Apigee APIs](/apigee/docs/reference/apis/apigee/rest).\n\nApigee hybrid implements the data collection pod as a [ReplicaSet](https://kubernetes.io/docs/concepts/workloads/controllers/replicaset/) with a minimum of two\nreplicas.\n\nThe following image shows the debug, analytics, and deployment status data collection process:\n\nNote that the debug, analytics, and deployment status data is not stored in the\nsame location or accessed in the same way as the logging and metrics data:\n\n- *Logging and metrics data* are stored on your Google Cloud Project and accessed via a tool such as Cloud Operations or whatever you choose to use.\n- *Debug, analytics and deployment status data* , on the other hand, is stored in the hybrid management plane and you access it via Apigee services such as the hybrid UI or [Apigee APIs](/apigee/docs/reference/apis/apigee/rest).\n\nThe following table summarizes the data collected by the data collection pod:\n\n| **TIP:** The *dataset name* is the name by which this type of data is referred to in the UDCA configuration properties. For example, analytics data is configured with the dataset name `api`. As a result, the configuration property that sets the location of the analytics data files is called **api**`DataSubDir`.\n|\n| You can access this data through the Apigee hybrid UI or [Apigee APIs](/apigee/docs/reference/apis/apigee/rest) on the management\n| plane.\n\nView the data in the hybrid UI\n------------------------------\n\nThis section describes how to view the debug, analytics, and deployment status data in the Apigee\nhybrid UI.\n\n### Debug\n\nDebug data for hybrid services is accessible in the same way as Edge debug data, with some\ndifferences such as increased filter support. For more\ninformation, see [Debug overview](/apigee/docs/api-platform/debug/trace-overview).\n\n### Analytics\n\nAnalytics data for hybrid services is accessible in the same way\nas Edge analytics data. For more information, see\n[Using the analytics dashboards](/apigee/docs/api-platform/analytics/using-analytics-dashboards) in\nthe Edge documentation.\n\n### Proxy deployment status\n\nFor information on viewing deployment status, see\n[View\ndeployment status](/apigee/docs/api-platform/deploy/ui-deploy-overview#viewing-deployment-status).\n\nConfigure the data collection\n-----------------------------\n\nTo set how and where debug, analytics, and deployment status data is\ncollected on the data collection pod, you configure the UDCA\nservice via its configuration properties. The UDCA properties\ninclude properties that are general to the UDCA as well as\nproperties that are specific to each dataset.\n\n**To configure the UDCA:**\n\n1. Open the `overrides.yaml` file for editing on your Kubernetes administration machine, as described in [Manage runtime plane components](/apigee/docs/hybrid/v1.3/customize-services).\n2. Set the values of the UDCA configuration settings. For the UDCA, you can set custom values for properties such as:\n - Polling interval\n - Number of replicas (min and max)\n - Target CPU percentage (that triggers additional replicas)\n\n For a complete list of UDCA properties that you can customize,\n see [`udca`](/apigee/docs/hybrid/v1.14/config-prop-ref#udca).\n3. Save your changes to the overrides.yaml file.\n4. Apply your changes by upgrading the `apigee-env` chart. \n\n ```\n helm upgrade ENV_NAME apigee-env/ \\\n --namespace apigee \\\n --set env=ENV_NAME \\\n --atomic \\\n -f overrides.yaml\n ```\n | **TIP** : To see the default configuration properties, the UDCA service (under `udca:`) in the [Configuration property reference](/apigee/docs/hybrid/v1.3/config-prop-ref)."]]
