Comment Snowflake représente les événements de trace¶

Procédure stockée avec gestionnaire Java¶

Le code Java de l’exemple suivant illustre la manière dont vous pouvez ajouter des événements à un span, ainsi que des données d’attribut. Pour plus d’informations sur des APIs pour les langages de gestionnaire, voir Traçage des événements à partir du code du gestionnaire.

CREATE OR REPLACE PROCEDURE test_stored_proc()
RETURNS STRING
LANGUAGE JAVA
RUNTIME_VERSION = '11'
PACKAGES=('com.snowflake:snowpark:latest', 'com.snowflake:telemetry:latest')
HANDLER = 'MyClass.run'
AS
$$
  import com.snowflake.snowpark_java.Session;
  import com.snowflake.telemetry.Telemetry;
  import io.opentelemetry.api.common.AttributeKey;
  import io.opentelemetry.api.common.Attributes;
  import io.opentelemetry.api.common.AttributesBuilder;

  public class MyClass {

    public String run(Session session) {
        // Adding an event without attributes.
        Telemetry.addEvent("testEvent");

        // Adding an event with attributes.
        Attributes eventAttributes = Attributes.of(
            AttributeKey.stringKey("key"), "run",
            AttributeKey.longKey("result"), Long.valueOf(123));
        Telemetry.addEvent("testEventWithAttributes", eventAttributes);

        // Setting span attributes of different types.
        Telemetry.setSpanAttribute("example.boolean", true);
        Telemetry.setSpanAttribute("example.long", 2L);
        Telemetry.setSpanAttribute("example.double", 2.5);
        Telemetry.setSpanAttribute("example.string", "testAttribute");

        return "SUCCESS";
    }
  }
$$;

Données enregistrées sur le span¶

Après l’exécution réussie de la fonction ou de la procédure, Snowflake rend l’objet de span OpenTelemetry sous forme d’objets dans les colonnes de la table d’événements, comme le montrent les tables suivantes.

Un span peut avoir ses propres attributs. Étant donné qu’un span représente une procédure stockée et une unité d’exécution d’UDF, il peut être utile de définir des attributs au niveau du span en vue d’une analyse ultérieure des données. Pour plus d’informations sur la définition des attributs de span, reportez-vous au contenu spécifique au langage dans lequel vous écrivez le code du gestionnaire. Pour une liste de ces langues, voir Traçage des événements à partir du code du gestionnaire.

Un span peut contenir un nombre maximal de 128 événements de trace et un nombre maximal de 128 attributs de span.

• Si le nombre d’événements de trace dépasse la limite, les événements sont abandonnés comme suit, en fonction du langage du gestionnaire :

  • Pour les gestionnaires Python, les événements sont abandonnés dans l’ordre dans lequel ils ont été ajoutés (en d’autres termes, dans l’ordre du « premier entré-premier sorti »).

  • Pour les gestionnaires écrits en Java, JavaScript, Scala et dans Exécution de scripts Snowflake, les nouveaux événements sont abandonnés une fois la limite atteinte.

• Si le nombre d’attributs de spans dépasse la limite, aucun attribut de span ne peut être ajouté.

Données d’événements enregistrées¶

Le span contient une liste d’événements de trace avec des horodatages qui capturent le moment où les événements de trace ont été ajoutés. Ce n’est pas montré ici : le span a un trace_id qui est l’ID de requête sans les tirets. Le span contient également des valeurs générées par le système pour les clés span_id et name. Les événements qui font partie du span partagent le même span_id.

Les données suivantes ont été enregistrées pour l’événement testEvent.

Les données suivantes ont été enregistrées pour l’événement testEventWithAttributes.