Trace Event Commands

CREATE EVENT TRACE

Creates a trace event.

Syntax

CREATE EVENT TRACE
    event_name
    [ WITH (<event_characteristic>, ...) ];

Where <event_characteristic> is an key/value pair, such as:

  • Query_text = on captures the query text

  • Duration_threshold_ms = 1000 traces all queries with runtimes over 1 second

  • Trace_all_failed_executions= on traces all queries that have failed, even when their runtimes are less than Duration_threshold_ms

Remarks

  • The event_name and event_characteristic keys are not case-sensitive.

  • Currently, Query_completion is the only usable event type.

  • The ALTER TRACE permission is required to create trace events.

  • Since event_characteristic key-value pairs are optional, each event trace has its own default values for a default configuration.

DROP EVENT TRACE

Drops a trace event.

Syntax

DROP EVENT TRACE event_name;

Remarks

  • The ALTER TRACE permission is required to drop trace events.

Last modified: July 29, 2024

Was this article helpful?

Verification instructions

Note: You must install cosign to verify the authenticity of the SingleStore file.

Use the following steps to verify the authenticity of singlestoredb-server, singlestoredb-toolbox, singlestoredb-studio, and singlestore-client SingleStore files that have been downloaded.

You may perform the following steps on any computer that can run cosign, such as the main deployment host of the cluster.

  1. (Optional) Run the following command to view the associated signature files.

    curl undefined
  2. Download the signature file from the SingleStore release server.

    • Option 1: Click the Download Signature button next to the SingleStore file.

    • Option 2: Copy and paste the following URL into the address bar of your browser and save the signature file.

    • Option 3: Run the following command to download the signature file.

      curl -O undefined
  3. After the signature file has been downloaded, run the following command to verify the authenticity of the SingleStore file.

    echo -n undefined |
    cosign verify-blob --certificate-oidc-issuer https://oidc.eks.us-east-1.amazonaws.com/id/CCDCDBA1379A5596AB5B2E46DCA385BC \
    --certificate-identity https://kubernetes.io/namespaces/freya-production/serviceaccounts/job-worker \
    --bundle undefined \
    --new-bundle-format -
    Verified OK