Trace Event Commands

On this page

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.

(Optional) Run the following command to view the associated signature files.
Shell
```
curl undefined
```
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.
  Shell
```
curl -O undefined
```

After the signature file has been downloaded, run the following command to verify the authenticity of the SingleStore file.

Shell

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