Télécharger les journaux sur la passerelle de données du réseau virtuel (VNet)

Vous pouvez télécharger les journaux de diagnostic de votre passerelle de données de réseau virtuel à partir de la page Gérer les connexions et les passerelles . Les sections suivantes décrivent chaque type de journal, sa période de rétention et son format de fichier et comment interpréter ses champs.

Note

  • Vous devez être administrateur sur la passerelle de données de réseau virtuel pour télécharger les journaux. Vérifiez l’option gérer les utilisateurs pour déterminer si vous êtes administrateur.
  • Les périodes de rétention des journaux sont fixes et ne peuvent pas être modifiées.
  • La passerelle doit être en ligne et en cours d’exécution pour générer des journaux. Les journaux collectés précédemment peuvent être téléchargés pendant que la passerelle est hors connexion, au cours de leur période de rétention. Vérifiez l’état du réseau virtuel en sélectionnant l’icône dans la colonne État.
  • Le téléchargement n’est pas disponible si Fabric Private Link est activé dans votre tenant.
  • Si vous ne voyez pas le téléchargement, vérifiez que les fenêtres contextuelles sont autorisées dans votre navigateur.
  • Cette fonctionnalité n’est pas disponible dans certaines régions et dans les régions US Gov Virginia.

Comment télécharger les journaux

  1. Dans l’en-tête de page du service Power BI, sélectionnez l’icône des Paramètres, puis sélectionnez Gérer les connexions et les passerelles.

  2. Sélectionnez l’onglet Passerelles de données de réseau virtuel.

  3. Recherchez votre passerelle de données du réseau virtuel et, dans la même ligne, sélectionnez l’icône de téléchargement.

    Capture d’écran de la page Gérer les connexions et les passerelles montrant l’icône de téléchargement des diagnostics

  4. Dans la fenêtre contextuelle, vous pouvez choisir la catégorie de journal spécifique dont vous avez besoin ou sélectionner tous les journaux disponibles. En outre, vous pouvez choisir un intervalle de temps prédéfini ou personnaliser l’intervalle de temps en fonction de vos besoins.

    Capture d’écran de la boîte de dialogue Télécharger les diagnostics dans laquelle vous choisissez la catégorie de journal et l’intervalle de temps

  5. Sélectionnez le bouton Télécharger les diagnostics et affichez les journaux dans le dossier téléchargé.

SystemCounters

Les compteurs système fournissent des mesures de processeur et de mémoire pour les instances de passerelle individuelles.

  • Période de rétention : 29 jours
  • Format : Parquet
Attribut Descriptif
Horodatage Heure à laquelle le compteur de métrique a été généré.
ID Identificateur unique de l’instance de passerelle (nœud) qui a signalé la mesure.
CommittedMemoryinMB Mémoire utilisée sur les 8 Go de RAM réservés par VNet.
Pourcentage d'utilisation du CPU (CPUUsagePercentage) CPU utilisée.
MémoireDisponibleEnMo Mémoire disponible.

MashupLogs

Les journaux Mashup contiennent des informations détaillées sur les actions effectuées par le moteur de Power Query. Utilisez ces journaux pour examiner l’exécution des requêtes et résoudre les erreurs.

  • Période de rétention : 48 heures
  • Format : JSONL
Attribut Descriptif
Commencer Début de l’action.
Action Nom de l’action.
ProductVersion Version de Mashup.
Id d'activité Identificateur d’activité.
CorrelationId Identificateur de corrélation.
Processus Nom du processus.
Pid Identificateur du processus.
Temps Identificateur du thread.
Durée Durée de l’action.

Rapport d'exécution de requête

Les rapports d’exécution des requêtes fournissent des informations sur les requêtes individuelles traitées par la passerelle, notamment leur état et leur minutage d’exécution. Utilisez ces rapports pour examiner les requêtes lentes ou ayant échoué et identifier l’instance de passerelle qui les a gérées.

  • Période de rétention : 29 jours
  • Format : Parquet
Attribut Descriptif
ID Identificateur de log.
Horodatage Début de l’exécution de la requête.
QueryId Identificateur de requête.
Identifiant d'instance Identificateur unique de l’instance de passerelle (nœud) qui a signalé l’enregistrement de diagnostic.
ID de demande Identificateur de demande.
Type de requête Type de requête, tel que DirectQuery ou les opérations d’actualisation des données, notamment les actualisations de modèle sémantique et de flux de données.
CheminDeConnexion Types de sources de données et chemins
État Indique si la requête a échoué ou réussi.
Heure de début Début de l’exécution de la requête.
DurationMS Durée de la requête en millisecondes.
HeureDeDébutD'Exécution Début de l’exécution de la requête.
ExecutionDurationMS Durée de la requête en millisecondes.
DataReadingAndSerializationStartTime Début de la sérialisation des données.
DuréeLectureEtSérialisationDonnéesMS Durée de la sérialisation des données.
StreamingDurationMS Durée du streaming des données.

Consommation des ressources

Les journaux de consommation de ressources enregistrent la consommation de capacité attribuée à la passerelle. Utilisez ces journaux pour examiner la consommation au fil du temps et identifier la capacité de Fabric associée.

  • Période de rétention : 29 jours
  • Format : Parquet
Attribut Descriptif
IdentifiantCapacité ID de la capacité facturée.
CapacityUnitSeconds Consommation de capacité émise, en tant que CapacityUnitSeconds.
GatewayId Identificateur de cluster de passerelle.
Nom de la passerelle Nom du cluster de passerelle.
Id Identificateur de log.
Horodatage La consommation de temps a été enregistrée.

PipelineExecutionReport et CopyJobExecutionReport

Ces rapports fournissent des informations sur les activités de pipeline et les tâches des travaux de copie que la passerelle traite. Ces rapports décrivent l’exécution de l’activité côté passerelle. Ils ne décrivent pas nécessairement l’intégralité du pipeline ou la durée de bout en bout de la tâche de copie. Utilisez-les pour examiner la file d’attente, la durée d’exécution, l’état et les erreurs.

  • Période de rétention : 29 jours
  • Format : Parquet
Attribut Descriptif
Id Identificateur unique pour le rapport de diagnostic.
Timestamp Heure à laquelle la passerelle génère le rapport, au format UTC.
InstanceId Identificateur unique de l’instance de passerelle (nœud) qui signale l’enregistrement de diagnostic.
RequestId Identificateur associé à la requête.
ArtifactType Type d’artefact associé à l’exécution.
TaskId Identificateur de la tâche d’exécution.
WorkspaceId Identificateur de l’espace de travail associé, le cas échéant.
PipelineRunId Identificateur de l’exécution du pipeline associé, le cas échéant.
PipelineName Nom du pipeline associé, le cas échéant.
ActivityRunId Identificateur de l’exécution de l’activité.
ActivityType Type d’activité.
QueueTime Temps passé en file d’attente signalé, en secondes.
Status État d’exécution signalé.
ExecutionStartTime Heure de début de l’exécution, en UTC.
ExecutionDurationMS Durée d’exécution, en millisecondes.
ErrorCode Code d’erreur associé à l’exécution, le cas échéant.

InstanceLoad

Les diagnostics de charge d’instance fournissent des mesures de charge de travail par instance de passerelle, notamment les signaux de charge utilisés par la mise à l’échelle automatique, les évaluations en file d’attente moyennes et les évaluations en cours d’exécution, ainsi que l’activité du pipeline. Utilisez ces journaux pour examiner la mise en file d’attente et la demande de charge de travail, et mettre en corrélation la charge avec les tendances historiques du nombre d’instances.

  • Période de rétention : 29 jours
  • Format : Parquet
Attribut Descriptif
Timestamp Heure à laquelle le rapport de chargement a été généré, au format UTC.
Id Identificateur unique de l’instance de passerelle (nœud) qui a signalé les mesures.
AggregateLoadPercent Signal de charge global que la mise à l’échelle automatique utilise pour l’instance de passerelle, en fonction de la demande d’évaluation et de l’activité du pipeline.
DefaultPoolLoadPercent Charge d’évaluation moyenne dans le pool par défaut, y compris les évaluations mises en file d’attente et en cours d’exécution, exprimée en pourcentage de la capacité du pool.
DefaultPoolAveragePendingCount Nombre moyen d’évaluations en attente d’exécution dans le pool par défaut.
DefaultPoolAverageRunningCount Nombre moyen d’évaluations exécutées dans le pool par défaut.
DirectQueryPoolLoadPercent Charge d’évaluation moyenne dans le pool DirectQuery, y compris les évaluations mises en file d’attente et en cours d’exécution, exprimée en pourcentage de la capacité du pool.
DirectQueryPoolAveragePendingCount Nombre moyen d’évaluations en attente d’exécution dans le pool DirectQuery.
DirectQueryPoolAverageRunningCount Nombre moyen d’évaluations exécutées dans le pool DirectQuery.
PipelinePoolActive Si le pool de pipelines a signalé une activité en cours. Cette valeur est un indicateur d’activité booléen, et non un pourcentage d’utilisation.

Pour comprendre les tendances historiques du nombre d’instances, regroupez les enregistrements en intervalles de temps et comptez les valeurs distinctes de Id dans chaque intervalle. Cette méthode indique le nombre d’instances ayant généré des journaux pendant chaque intervalle, pas nécessairement le nombre d’instances en cours d’exécution simultanément.