GraphQL-Vorgänge
GraphQL-Vorgangsprotokolle sind Teil der Protokolle Arbeitsbereichsüberwachung und werden in der Eventhouse-KQL-Datenbank registriert, die Teil der Echtzeitintelligenzlösung ist. Sie können diese Protokolle verwenden, um die Nutzung und Leistung Ihres Arbeitsbereichs zu überwachen.
GraphQL-Vorgangsprotokolle
Ein Protokollereignis für jede Abfrage, die von der Fabric-API für GraphQL in den verbundenen Datenquellen ausgeführt wird, wird in zwei Tabellen gespeichert: GraphQLMetrics und GraphQLLog.
Verwenden Sie Abfrageprotokolle für Folgendes:
- Identifizieren Sie Verhaltensänderungen und potenzielle API-Beeinträchtigungen.
- Erkennen Sie ungewöhnliche oder ressourcenintensive Abfragen.
- Identifizieren Sie Benutzer und Anwendungen mit der höchsten Anzahl von Abfragen.
- Analysieren Sie Abfrageleistung und -trends.
- Beheben Sie Probleme mit langsamen Abfragen.
- Diagnostizieren Sie Probleme mit bestimmten GraphQL-Abfragen.
In dieser Tabelle sind die GraphQL-Protokolle aufgeführt.
| Spaltenname | type | BESCHREIBUNG |
|---|---|---|
| Timestamp | datetime | Der Zeitstempel (UTC) des Zeitpunkts, zu dem der Protokolleintrag generiert wurde, als der Datensatz von der Datenquelle erstellt wurde. |
| ItemId | Zeichenfolge | Eindeutige ID der Ressource, die die Daten protokolliert. |
| ItemKind | Zeichenfolge | Typ des Artefakts, das den Vorgang protokolliert. |
| Artikelname | Zeichenfolge | Der Name der Fabric-Artefaktprotokollierung für diesen Vorgang. |
| WorkspaceId | Zeichenfolge | Eindeutiger Bezeichner des Fabric-Arbeitsbereichs, der das Artefakt enthält, das vom Vorgang betroffen ist. |
| WorkspaceName | Zeichenfolge | Name des Fabric-Arbeitsbereichs, der das Artefakt enthält. |
| CapacityId | Zeichenfolge | Eindeutiger Bezeichner der Kapazität, die das Artefakt hostet, das vom Vorgang betroffen ist. |
| CustomerTenantId | Zeichenfolge | Kundenmandanten-ID, in der der Vorgang ausgeführt wurde. |
| PlatformMonitoringTableName | Zeichenfolge | Der Name der Tabelle, zu der Datensätzen gehört (oder der zertifizierte Ereignistyp des Datensatzes). Das Format lautet <WorkloadName> + [OperationType>]+ <TelemetryType> |
| Region | Zeichenfolge | Die Region der Ressource, die das Ereignis ausgibt, z. B USA, Osten oder Frankreich, Süden. |
| MetricTimeGrain | Zeichenfolge | Aggregationsintervall der Metrik (ISO 8601 Duration). |
| MetricUnitName | Zeichenfolge | Einheit der Metrik |
| MetricSumValue | long | Der aggregierte Summenwert einer Metrik während einer einzelnen Minute. |
| DatasourceTypes | dynamisch | Array von DataSource-Typen, die vom Modell verwendet werden. |
| ResultCode | Zeichenfolge | Fehlercode der fehlgeschlagenen Aktivitäten, der verwendet wird, um den Verbrauch auf die Zuverlässigkeit auszudehnen. |
| Status | Zeichenfolge | Der Status des Vorgangs. Die Abfrage war erfolgreich/erfolgreich mit Fehlern/fehlerhaft. |
GraphQL-Protokollattribute
In dieser Tabelle werden die GraphQLLogs-Attribute beschrieben. Weitere Informationen zu den Ereignissen und einem Drilldown zum ExecutionMetrics-Ereignis finden Sie unter Ereignisse und Schema.
| Spaltenname | type | BESCHREIBUNG |
|---|---|---|
| Timestamp | datetime | Der Zeitstempel (UTC) des Zeitpunkts, zu dem der Protokolleintrag generiert wurde, als der Datensatz von der Datenquelle erstellt wurde. |
| Vorgangsname | Zeichenfolge | Der Name des Vorgangs. |
| ItemId | Zeichenfolge | Eindeutige ID der Ressource, die die Daten protokolliert. |
| ItemKind | Zeichenfolge | Typ des Artefakts, das den Vorgang protokolliert. |
| Artikelname | Zeichenfolge | Der Name der Fabric-Artefaktprotokollierung für diesen Vorgang. |
| WorkspaceId | Zeichenfolge | Eindeutiger Bezeichner des Fabric-Arbeitsbereichs, der das Artefakt enthält, das vom Vorgang betroffen ist. |
| WorkspaceName | Zeichenfolge | Name des Fabric-Arbeitsbereichs, der das Artefakt enthält. |
| CapacityId | Zeichenfolge | Eindeutiger Bezeichner der Kapazität, die das Artefakt hostet, das vom Vorgang betroffen ist. |
| CorrelationId | Zeichenfolge | Stamm-Aktivitäts-ID. |
| OperationId | Zeichenfolge | Eindeutiger Bezeichner für den protokollierten Vorgang. |
| Identität | dynamisch | Benutzer- und Anspruchsdetails. Der Benutzer, der dem gemeldeten Vorgang zugeordnet ist. |
| CustomerTenantId | Zeichenfolge | Kundenmandanten-ID, in der der Vorgang ausgeführt wurde. |
| DurationMs | long | Verstrichene CPU-Zeit, die überschritten wurde, während alle erforderlichen Vorgänge verarbeitet wurden. Einheit in Millisekunden. |
| Status | Zeichenfolge | Der Status des Vorgangs. Die Abfrage war erfolgreich/erfolgreich mit Fehlern/fehlerhaft. |
| Ebene | Zeichenfolge | Metadaten, die vom Plattformüberwachungsteam benötigt werden. |
| Region | Zeichenfolge | Die Region der Ressource, die das Ereignis ausgibt, z. B USA, Osten oder Frankreich, Süden. |
| PlatformMonitoringTableName | Zeichenfolge | Der Name der Tabelle, zu der Datensätzen gehört (oder der zertifizierte Ereignistyp des Datensatzes). Das Format lautet <WorkloadName> + [OperationType>]+ <TelemetryType> |
| QueryText | Zeichenfolge | Der Text der Abfrage. |
| GraphQLOverheadDurationMs | long | Der GraphQL-Overhead in ms für eine Datenebenenanforderung. |
| ProcessedBytes | long | Verarbeitetes Datenvolume in Byte. |
| TransportProtocol | Zeichenfolge | Transportprotokoll für eine Anforderung. |
| QueryResultMessage | Zeichenfolge | Diese Dimension wird verwendet, um dem Ergebnis eines Abfragevorgangs zusätzlichen Kontext zu geben. |
Beispielabfragen
Sie finden Beispielabfragen im GitHub-Repository fabric-samples.