Opérations GraphQL
Les journaux d’opération GraphQL font partie des journaux d’analyse de l’espace de travail et sont inscrits dans la base de données Eventhouse KQL, qui fait partie de la solution Real-Time Intelligence. Vous pouvez utiliser ces journaux pour contrôler l'utilisation et les performances de votre espace de travail.
Journaux d’opérations GraphQL
Un événement de journal pour chaque requête exécutée par l’API Fabric pour GraphQL sur ses sources de données connectées est stocké dans deux tables : GraphQLMetrics et GraphQLLog.
Utilisez les journaux de requête pour :
- Identifier les changements de comportement et la dégradation potentielle de l'API.
- Détecter les requêtes inhabituelles ou gourmandes en ressources.
- Identifier les utilisateurs et les applications avec le plus grand nombre de requêtes
- Analyser les performances et les tendances des requêtes.
- Résoudre les problèmes de requêtes lentes.
- Diagnostiquer les problèmes liés à des requêtes GraphQL spécifiques.
Ce tableau répertorie les journaux GraphQL.
| Nom de la colonne | Type | Description |
|---|---|---|
| Timestamp | DATETIME | L'horodatage (UTC) du moment où l'entrée du journal a été générée lorsque l'enregistrement a été créé par la source de données. |
| ItemId | string | ID unique de la ressource qui journalise les données. |
| ItemKind | string | Type d’artefact qui journalise l’opération. |
| ItemName | string | Le nom de l'artefact Fabric qui enregistre cette opération. |
| WorkspaceId | string | Identificateur unique de l’espace de travail Fabric qui contient l’artefact utilisé |
| WorkspaceName | string | Nom de l'espace de travail Fabric contenant l'artefact. |
| CapacityId | string | Identificateur unique de la capacité qui héberge l’artefact utilisé. |
| CustomerTenantId | string | Customer Tenant ID, où l'opération a été effectuée. |
| PlatformMonitoringTableName | string | Le nom de la table à laquelle appartient l'enregistrement (ou le type d'événement certifié de l'enregistrement). Format : <WorkloadName> + [OperationType>]+ <TelemetryType> |
| Région | string | Région de la ressource émettant l’événement ; par exemple, USA Est ou France Sud. |
| MetricTimeGrain | string | Fragment de temps de la mesure (durée ISO 8601). |
| MetricUnitName | string | Unité de la métrique. |
| MetricSumValue | long | La valeur totale agrégée d'une métrique pendant une minute. |
| DatasourceTypes | dynamic | Tableau des types de DataSource utilisées par le modèle. |
| ResultCode | string | Code d'erreur des activités qui ont échoué, utilisé pour étendre l'utilisation à la fiabilité. |
| État | string | État de l’opération. La requête a été exécutée avec succès, avec des erreurs ou a échoué. |
Attributs de journal GraphQL
Ce tableau décrit les attributs de GraphQLLogs. Pour plus d’informations sur les événements et une exploration dans l’événement ExecutionMetrics, consultez Événements et schéma.
| Nom de la colonne | Type | Description |
|---|---|---|
| Timestamp | DATETIME | L'horodatage (UTC) du moment où l'entrée du journal a été générée lorsque l'enregistrement a été créé par la source de données. |
| NomOpération | string | Nom de l'opération. |
| ItemId | string | ID unique de la ressource qui journalise les données. |
| ItemKind | string | Type d’artefact qui journalise l’opération. |
| ItemName | string | Le nom de l'artefact Fabric qui enregistre cette opération. |
| WorkspaceId | string | Identificateur unique de l’espace de travail Fabric qui contient l’artefact utilisé. |
| WorkspaceName | string | Nom de l'espace de travail Fabric contenant l'artefact. |
| CapacityId | string | Identificateur unique de la capacité qui héberge l’artefact utilisé. |
| CorrelationId | string | ID activité racine. |
| OperationId | string | Identificateur unique pour l'opération enregistrée. |
| Identité | dynamic | Données relatives à l'utilisateur et à la demande d'indemnisation. Données relatives à l'utilisateur et à la demande d'indemnisation. |
| CustomerTenantId | string | Customer Tenant ID, où l'opération a été effectuée. |
| DurationMs | long | Temps processeur écoulé pendant que toutes les opérations requises ont été traitées. L'unité est en millisecondes. |
| État | string | État de l’opération. La requête a été exécutée avec succès, avec des erreurs ou a échoué. |
| Niveau | string | Métadonnées requises par l'équipe de surveillance de la plate-forme. |
| Région | string | Région de la ressource émettant l’événement ; par exemple, USA Est ou France Sud. |
| PlatformMonitoringTableName | string | Le nom de la table à laquelle appartient l'enregistrement (ou le type d'événement certifié de l'enregistrement). Format : <WorkloadName> + [OperationType>]+ <TelemetryType> |
| QueryText | string | Texte de la requête. |
| GraphQLOverheadDurationMs | long | Le traitement GraphQL en ms pour une requête de plan de données. |
| ProcessedBytes | long | Volume de données traitées en octets. |
| TransportProtocol | string | Protocole de transport pour une requête. |
| QueryResultMessage | string | Cette dimension est utilisée pour donner un contexte supplémentaire au résultat d'une opération de recherche. |
Exemples de requêtes
Vous trouverez des exemples de requêtes dans le référentiel GitHub fabric-sample.