Présentation des exportations de données Trace

Bêta

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent bénéficier d'une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Cette page offre un aperçu conceptuel de l'exportation des données de trace à l'aide de Cloud Trace. Vous pouvez exporter les données de trace pour les raisons suivantes :

• Stocker les données de trace pendant une période supérieure à la période de conservation par défaut de 30 jours.

• Pour vous permettre d'utiliser les outils BigQuery afin d'analyser vos données de trace. Par exemple, avec BigQuery, vous pouvez identifier les décomptes de délais et les quantiles. Pour en savoir plus sur la requête utilisée pour générer la table suivante, consultez la section Requête HipsterShop.

  

Fonctionnement des exportations

L'exportation implique de créer un récepteur pour un projet Google Cloud. Un récepteur définit un ensemble de données BigQuery comme destination.

Vous pouvez créer un récepteur à l'aide de l'API Cloud Trace ou de la Google Cloud CLI.

Propriétés et terminologie des récepteurs

Les récepteurs sont définis pour un projet Google Cloud et possèdent les propriétés suivantes :

• Nom : nom du récepteur. Par exemple, un nom peut être :

  "projects/PROJECT_NUMBER/traceSinks/my-sink"
  

  où PROJECT_NUMBER est le numéro du projet Google Cloud du récepteur et my-sink l'identifiant du récepteur.

• Parent : ressource dans laquelle vous créez le récepteur. Le parent doit être un projet Google Cloud :

  "projects/PROJECT_ID"
  

  Le PROJECT_ID peut être un identifiant ou un numéro de projet Google Cloud.

• Destination : emplacement unique pour envoyer des délais de trace. Trace permet d'exporter des traces vers BigQuery. La destination peut être le projet Google Cloud du récepteur ou tout autre projet Google Cloud appartenant à la même organisation.

  Par exemple, une destination valide est :

  bigquery.googleapis.com/projects/DESTINATION_PROJECT_NUMBER/datasets/DATASET_ID
  

  où DESTINATION_PROJECT_NUMBER est le numéro du projet Google Cloud de la destination et DATASET_ID l'identifiant de l'ensemble de données BigQuery.

• Identité du rédacteur : un nom de compte de service. Le propriétaire de la destination d'exportation doit autoriser ce compte de service à écrire sur la destination d'exportation. Lors de l'exportation des traces, Trace adopte cette identité pour l'autorisation. Pour une sécurité accrue, les nouveaux récepteurs obtiennent un compte de service unique :

  [e-mail]
  

  où PROJECT_NUMBER est le numéro de votre projet Google Cloud, dans Hex, et GENERATED_VALUE une valeur générée de manière aléatoire.

  Vous ne créez, ne possédez ni ne gérez pas le compte de service identifié par l'identité du rédacteur d'un récepteur. Lorsque vous créez un récepteur, Trace crée le compte de service requis par le récepteur. Ce compte de service n'est pas inclus dans la liste des comptes de service de votre projet tant qu'il n'a pas au moins une liaison Identity and Access Management. Vous ajoutez cette liaison lorsque vous configurez une destination de récepteur.

  Pour en savoir plus sur l'utilisation de l'identité du rédacteur, consultez la section Autorisations de destination.

Fonctionnement des récepteurs

Chaque fois qu'un délai de trace arrive dans un projet, Trace exporte une copie du délai.

Les traces reçues par Trace avant la création du récepteur ne peuvent pas être exportées.

Contrôle des accès

Pour créer ou modifier un récepteur, vous devez disposer de l'un des rôles de gestion de l'authentification et des accès suivants :

• Administrateur de trace
• Utilisateur de Trace
• Propriétaire du projet
• Éditeur de projet

Pour plus d'informations, consultez la section Contrôle des accès.

Pour exporter des traces vers une destination, le compte de service "Rédacteur" du récepteur doit disposer d'un accès en écriture sur la destination. Pour en savoir plus sur les identités de rédacteur, consultez la section Propriétés des récepteurs sur cette page.

Quotas et limites

Cloud Trace utilise l'API de streaming BigQuery pour envoyer des délais de trace à la destination. Cloud Trace regroupe les appels d'API par lots. Cloud Trace ne met pas en œuvre de mécanisme de nouvelle tentative ou de limitation. Les délais de trace peuvent ne pas être exportés correctement si la quantité de données dépasse les quotas de destination.

Pour plus d'informations sur les quotas et les limites de BigQuery, consultez la page Quotas et limites.

Tarification

L'exportation de traces n'entraîne pas de frais pour Cloud Trace. Toutefois, des frais BigQuery peuvent s'appliquer. Pour plus d'informations, consultez la page Tarifs de BigQuery.

Estimer vos coûts

BigQuery facture l'ingestion et le stockage des données. Pour estimer vos coûts BigQuery mensuels, procédez comme suit :

1. Estimez le nombre total de délais de trace ingérés au cours d'un mois.

   Pour savoir comment afficher l'utilisation, consultez la section Afficher l'utilisation par compte de facturation.

2. Estimez les besoins en streaming en fonction du nombre de délais de trace ingérés.

   Chaque délai est écrit dans une ligne de table. Chaque ligne de BigQuery nécessite au moins 1 024 octets. Par conséquent, une limite inférieure de vos exigences de streaming BigQuery implique d'attribuer 1 024 octets à chaque délai. Par exemple, si votre projet Google Cloud a ingéré 200 délais, ces délais nécessitent au moins 20 400 octets pour l'insertion en flux continu.

3. Utilisez le Simulateur de coût pour estimer vos coûts BigQuery liés au stockage, aux insertions en flux continu et aux requêtes.

Afficher et gérer l'utilisation de BigQuery

Vous pouvez utiliser l'Explorateur de métriques pour afficher votre utilisation de BigQuery. Vous pouvez également créer une règle d'alerte qui vous avertit si votre utilisation de BigQuery dépasse les limites prédéfinies. Le tableau suivant contient les paramètres permettant de créer une règle d'alerte. Vous pouvez utiliser les paramètres figurant dans la table du volet cible lors de la création d'un graphique ou lorsque vous utilisez l'Explorateur de métriques.

Pour créer une règle d'alerte qui se déclenche lorsque les métriques BigQuery ingérées dépassent un niveau défini par l'utilisateur, utilisez les paramètres suivants.

Procédure permettant de créer une règle d'alerte

Pour créer une règle d'alerte, procédez comme suit :

1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis  Alertes :

   Accéder à l'interface des alertes

2. Si vous n'avez pas créé vos canaux de notification et que vous souhaitez être averti, cliquez sur Modifier les canaux de notification et ajoutez vos canaux de notification. Revenez à la page Alertes après avoir ajouté vos canaux.
3. Sur la page Alertes, cliquez sur Créer une règle.
4. Pour sélectionner la ressource, la métrique et les filtres, développez le menu Sélectionner une métrique, puis utilisez les valeurs du tableau Nouvelle condition :
   1. (Facultatif) Pour limiter le menu aux entrées pertinentes, saisissez le nom de la ressource ou de la métrique dans la barre de filtre.
   2. Sélectionner un type de ressource Par exemple, sélectionnez Instance de VM.
   3. Sélectionnez une catégorie de métriques. Par exemple, sélectionnez instance.
   4. Sélectionnez une métrique. Par exemple, sélectionnez Utilisation du processeur.
   5. Sélectionnez Appliquer.
5. Cliquez sur Suivant, puis configurez le déclencheur de règle d'alerte. Pour renseigner ces champs, utilisez les valeurs du tableau Configurer le déclencheur d'alerte.
6. Cliquez sur Suivant.

7. Facultatif : Pour ajouter des notifications à votre règle d'alerte, cliquez sur Canaux de notification. Dans la boîte de dialogue, sélectionnez un ou plusieurs canaux de notification dans le menu, puis cliquez sur OK.

   Pour recevoir une notification en cas d'ouverture et de fermeture d'un incident, cochez la case Notifier en cas de fermeture des incidents. Par défaut, les notifications ne sont envoyées que lorsque des incidents sont ouverts.

8. (Facultatif) Mettez à jour la durée de fermeture automatique de l'incident. Ce champ détermine à quel moment Monitoring ferme les incidents en l'absence de données de métriques.
9. Facultatif : Cliquez sur Documentation, puis ajoutez les informations à inclure dans le message de notification.
10. Cliquez sur Nom de l'alerte et saisissez un nom pour la règle d'alerte.
11. Cliquez sur Créer une règle.

ChampNouvelle condition	Valeur
Ressource et métrique	Dans le menu Ressources, sélectionnez Ensemble de données BigQuery. Dans le menu Catégories de métriques, sélectionnez Stockage. Sélectionnez une métrique dans le menu Métriques. Les métriques propres à l'utilisation incluent Stored bytes, Uploaded bytes et Uploaded bytes billed. Pour obtenir la liste complète des métriques disponibles, consultez la page Métriques BigQuery.
Filter	project_id : ID de votre projet Google Cloud dataset_id : ID de votre ensemble de données
Dans toutes les séries temporelles Regrouper les séries temporelles par	dataset_id : ID de votre ensemble de données
Dans toutes les séries temporelles Agrégation de séries temporelles	sum
Fenêtre glissante	1 m
Fenêtrage glissant	mean

Champ Configurer le déclencheur d'alerte	Valeur
Type de condition	Threshold
Déclencheur d'alerte	Any time series violates
Position du seuil	Above threshold
Valeur du seuil	Vous définissez la valeur acceptable.
Fenêtre du nouveau test	1 minute

Étapes suivantes

Pour configurer un récepteur, consultez la page Exporter des traces.