package v1.public.events.vsce
Get desktop application:
View/edit binary Protocol Buffers messages
message
vscode.proto:11optional enrichment = 1
optional editor = 2
optional user = 3
string os_name = 4
os name
string os_version = 5
os version
bool init_success = 6
whether the extension was able to initialize successfully
string init_error = 7
type of initializion error, if an error occurred at initialization
string init_error_detail = 8
detailed error message, if an error occurred at initialization
int64 init_duration_ms = 9
duration of the initialization in milliseconds
bool is_lsp_installed = 10
does the user have LSP installed
bool is_fusion_installed = 11
does the user have fusion installed
string dbt_version = 12
the version of dbt used in the project
string dbt_local_cookie_user_id = 13
the anonymous user id stored at ~/.dbt/.user.yml
int32 models_count = 14
project models count
string adapter_type = 15
the type of adapter used in the project (snowflake, bigquery, etc)
fields.vscode_types.OAuthSessionFileActionAtActivation oauth_session_file_action = 16
Outcome of OAuth session file load at activation.
message
vscode.proto:185optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
message
vscode.proto:257optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
message
vscode.proto:436optional enrichment = 1
optional editor = 2
optional user = 3
string compare_id = 4
anonymized identifier for this compare session
int64 duration_ms = 5
duration of the compare operation in milliseconds
bool compare_success = 6
whether the compare operation completed successfully
string failure_reason = 7
Deprecated: use failure_mode and error_message instead
string dbt_local_cookie_user_id = 8
the anonymous user id stored at ~/.dbt/.user.yml
string event_id = 9
UUID to uniquely identify the event
fields.vscode_types.CompareFailureMode failure_mode = 10
categorizes the type of failure that occurred
string error_message = 11
detailed error message or logs from the failed operation
uint32 artifact_results_count = 12
number of result rows reported by the compare artifact
bool artifact_has_project = 13
whether the compare artifact contained a project section
string artifact_dbt_schema_version = 14
dbt schema version reported by the compare artifact (e.g., the manifest schema URL/version)
string artifact_invocation_id = 15
invocation_id reported by the compare artifact (correlates to the dbt run that produced it)
message
vscode.proto:484Emitted when the user opens (drills into) a single row in the Compare panel results table. Pairs with ExtensionCompareStarted/Finished via compare_id.
optional enrichment = 1
optional editor = 2
optional user = 3
string compare_id = 4
anonymized identifier for the compare session this row belongs to
string dbt_local_cookie_user_id = 5
the anonymous user id stored at ~/.dbt/.user.yml
string event_id = 6
UUID to uniquely identify the event
string diff_type = 7
category of diff row that was opened. One of: 'value_diff' | 'added_record' | 'removed_record' | 'non_unique_record' | 'unknown'. Kept as a string for forward-compat (no enum needed today).
message
vscode.proto:417optional enrichment = 1
optional editor = 2
optional user = 3
string compare_id = 4
anonymized identifier for this compare session
string dbt_local_cookie_user_id = 5
the anonymous user id stored at ~/.dbt/.user.yml
string event_id = 6
UUID to uniquely identify the event
message
vscode.proto:401optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string event_id = 5
UUID to uniquely identify the event
message
vscode.proto:159optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
message
vscode.proto:788Emitted when the user interacts with the Get Started onboarding panel: either clicking a CTA or transitioning a step's status (including completing all steps).
optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string event_id = 5
UUID to uniquely identify the event
fields.vscode_types.GetStartedInteractionType interaction_type = 6
type of interaction (CTA click or step transition)
fields.vscode_types.GetStartedStepId step_id = 7
step the interaction targets; UNSPECIFIED for ALL_STEPS_COMPLETED and MIGRATE_WITH_AGENT_CLICKED (the migrate CTA is not itself one of the four steps)
fields.vscode_types.GetStartedStepStatus current_step_status = 8
status of step_id at the time of the event
int32 steps_completed_count = 9
count of steps with status=COMPLETED at the time of the event (0–4)
message
vscode.proto:302optional enrichment = 1
optional editor = 2
optional user = 3
string support_type = 4
the type of support that was clicked
string dbt_local_cookie_user_id = 5
the anonymous user id stored at ~/.dbt/.user.yml
message
vscode.proto:369optional enrichment = 1
optional editor = 2
optional user = 3
string support_type = 4
the type of support being cancelled
string dbt_local_cookie_user_id = 5
the anonymous user id stored at ~/.dbt/.user.yml
message
vscode.proto:318optional enrichment = 1
optional editor = 2
optional user = 3
string support_type = 4
the type of support being offered
string dbt_local_cookie_user_id = 5
the anonymous user id stored at ~/.dbt/.user.yml
message
vscode.proto:350optional enrichment = 1
optional editor = 2
optional user = 3
string support_type = 4
the type of support that was submitted
bool success = 5
whether the submission was successful
string dbt_local_cookie_user_id = 6
the anonymous user id stored at ~/.dbt/.user.yml
message
vscode.proto:385optional enrichment = 1
optional editor = 2
optional user = 3
string support_type = 4
the type of support panel that was closed
string dbt_local_cookie_user_id = 5
the anonymous user id stored at ~/.dbt/.user.yml
message
vscode.proto:286optional enrichment = 1
optional editor = 2
optional user = 3
string support_type = 4
the type of support being offered
string dbt_local_cookie_user_id = 5
the anonymous user id stored at ~/.dbt/.user.yml
message
vscode.proto:334optional enrichment = 1
optional editor = 2
optional user = 3
string support_type = 4
the type of support being offered
string dbt_local_cookie_user_id = 5
the anonymous user id stored at ~/.dbt/.user.yml
message
vscode.proto:201Emitted when the user interacts with the lineage panel (node click, context menu action, grain switch, or toolbar action). A single event covers all interaction types; distinguish between them via `interaction_type`.
optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
fields.vscode_types.LineageInteractionType interaction_type = 5
which kind of interaction the user performed
fields.vscode_types.LineageGrain grain = 6
grain active in the panel when the interaction was initiated. For LINEAGE_INTERACTION_TYPE_SWITCH_TO_* interactions, this is the source (from) grain, not the destination. Analytics can derive the destination from interaction_type.
string resource_type = 7
dbt resource_type for the target node, when applicable (model, source, seed, snapshot, exposure, metric, etc.). Free string so new dbt resource types don't require a proto bump.
string lens = 8
selected lens value; set only when interaction_type == LINEAGE_INTERACTION_TYPE_LENS_CHANGED
message
vscode.proto:172optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
message
vscode.proto:98optional enrichment = 1
optional editor = 2
optional user = 3
string project_id = 4
this is the hash of the project's name, used for anonymized telemetry
string adapter_type = 5
the type of adapter used in the project (snowflake, bigquery, etc)
string adapter_unique_id = 6
the unique id of the adapter used in the active profile eg. md5(hostname)
string dbt_version = 7
the version of dbt used in the project
bool compile_success = 8
Indicates whether the compile was successful
repeated errors = 9
int64 duration_ms = 10
duration of the compile in milliseconds
fields.vscode_types.CompileType compile_type = 11
the type of compile
int32 models_count = 12
project models count
bool user_initiated = 13
True if the compile was triggered by a user action (ie. saving a file)
fields.vscode_types.CompileCause compile_cause = 14
The event that triggered the compile
string dbt_local_cookie_user_id = 15
the anonymous user id stored at ~/.dbt/.user.yml
message
vscode.proto:61optional enrichment = 1
optional editor = 2
optional user = 3
string project_id = 4
this is the hash of the project's name, used for anonymized telemetry
string adapter_type = 5
the type of adapter used in the project (snowflake, bigquery, etc)
string adapter_unique_id = 6
the unique id of the adapter used in the active profile eg. md5(hostname)
string dbt_version = 7
the version of dbt used in the project
fields.vscode_types.CompileType compile_type = 8
the type of compile
bool user_initiated = 9
True if the compile was triggered by a user action (ie. saving a file)
fields.vscode_types.CompileCause compile_cause = 10
The event that triggered the compile
string dbt_local_cookie_user_id = 11
the anonymous user id stored at ~/.dbt/.user.yml
string event_id = 12
UUID to uniquely identify the event
message
vscode.proto:739optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string correlation_id = 5
UUID generated per panel render; matches ExtensionModelDocsPanelOpened.correlation_id
string project_id = 6
md5 hash of the dbt project name (anonymized)
fields.vscode_types.ModelDocsEnrichmentOutcome outcome = 7
which cloud-enrichment code path the render took
int64 duration_ms = 8
wall-clock duration from start of enrichFromCloud() to outcome emission
string error_message = 9
sanitized error message (error.name + ": " + error.message, max 512 chars); empty on success/skip
message
vscode.proto:720optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string correlation_id = 5
UUID generated per panel render; matches ExtensionModelDocsPanelOpened.correlation_id
string project_id = 6
md5 hash of the dbt project name (anonymized)
message
vscode.proto:698optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string correlation_id = 5
UUID generated per panel render; joins all 4 Model Docs events for one render
string project_id = 6
md5 hash of the dbt project name (anonymized) — same hash as ExtensionLspCompileStart.project_id
bool cloud_configured = 7
true if dbt Cloud credentials were available at panel-open time
message
vscode.proto:767optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string correlation_id = 5
UUID generated per panel render; matches ExtensionModelDocsPanelOpened.correlation_id
string project_id = 6
md5 hash of the dbt project name (anonymized)
message
vscode.proto:244optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
message
vscode.proto:934Emitted when the extension adopts an OAuth session from the on-disk session file into SecretStorage (cross-process credential sharing).
optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string event_id = 5
UUID to uniquely identify the event
fields.vscode_types.OAuthSessionAdoptTrigger trigger = 6
message
vscode.proto:953Emitted when the extension persists its OAuth session to the on-disk session file.
optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string event_id = 5
UUID to uniquely identify the event
fields.vscode_types.OAuthSessionPersistTrigger trigger = 6
bool is_first_write = 7
True when this write created our slot for the first time (no prior slot existed).
message
vscode.proto:847Emitted when a query in the Query Results panel finishes (success, failure, cancellation, or invalid target). Pairs with ExtensionQueryStarted via query_id.
optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string query_id = 5
UUID identifying this query lifecycle; matches ExtensionQueryStarted.query_id.
fields.vscode_types.QueryOrigin query_origin = 6
which entry point started the query
string adapter_type = 7
adapter type used in the active profile (snowflake, bigquery, etc.)
string project_id = 8
md5 hash of the dbt project name (anonymized)
int64 duration_ms = 9
wall-clock duration from start to completion in milliseconds
int32 row_count = 10
number of rows returned; 0 on non-success
fields.vscode_types.QueryCompletionStatus status = 11
outcome of the query
string error_message = 12
sanitized error message (max 512 chars, newlines stripped); empty on success/cancel/invalid
message
vscode.proto:886Emitted when a user interacts with the Query Results panel after results render. Correlates to a specific result set via query_id.
optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string query_id = 5
UUID identifying the active result set; matches ExtensionQueryStarted.query_id.
fields.vscode_types.QueryResultInteractionType interaction_type = 6
which kind of interaction the user performed
message
vscode.proto:819Emitted when a query begins in the Query Results panel. Pairs with ExtensionQueryCompleted via query_id.
optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string query_id = 5
UUID identifying this query lifecycle; matches ExtensionQueryCompleted.query_id and ExtensionQueryResultInteracted.query_id for the same result set.
fields.vscode_types.QueryOrigin query_origin = 6
which entry point started the query
string adapter_type = 7
adapter type used in the active profile (snowflake, bigquery, etc.)
string project_id = 8
md5 hash of the dbt project name (anonymized); same md5(project_name) used by compile events
message
vscode.proto:676Emitted when the user clicks a control to begin registration Used to correlate subsequent registration events with the originating click
optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string event_id = 5
UUID to uniquely identify the event
string target = 6
UI element that was clicked to start registration (e.g., status bar, banner, extension info)
string correlation_id = 7
identifier to correlate related registration events
message
vscode.proto:526Emitted if the user starts the registration flow. There are several UI affordances to do this.
optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string event_id = 5
UUID to uniquely identify the event
fields.vscode_types.RegistrationTriggerMethod trigger_method = 6
which registration path will be used
string correlation_id = 7
identifier to correlate related registration events (matches RegisterClicked)
message
vscode.proto:580Emitted when the user successfully completes registration
optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string event_id = 5
UUID to uniquely identify the event
fields.vscode_types.RegistrationMethod registration_method = 6
the actual registration method used
int64 duration_ms = 7
duration of the registration flow in milliseconds
string correlation_id = 8
identifier to correlate related registration events (matches RegisterClicked)
string account_id = 9
dbt Cloud account ID the user registered with
string user_id = 10
dbt Cloud user ID for the registered user
string account_host = 11
dbt Cloud hostname (e.g., cloud.getdbt.com)
message
vscode.proto:643Emitted when an error occurs during registration These are most likely to be caused by issues in code (bugs, unanticipated cases, regressiones)
optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string event_id = 5
UUID to uniquely identify the event
fields.vscode_types.RegistrationMethod registration_method = 6
the registration method that errored (use UNSPECIFIED if not yet known)
string error_type = 7
type/category of error that occurred
string error_message = 8
sanitized error message (no PII)
int64 duration_ms = 9
duration until error in milliseconds
string correlation_id = 10
identifier to correlate related registration events (matches RegisterClicked)
message
vscode.proto:509Emited if the user dismiss a message prompting them to register the extension?
optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string event_id = 5
UUID to uniquely identify the event
message
vscode.proto:616Once a user starts registration, they must complete it within 10 minutes After 10 minutes, the auth server shuts down and we emit this event
optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string event_id = 5
UUID to uniquely identify the event
fields.vscode_types.RegistrationTriggerMethod trigger_method = 6
the registration trigger method that timed out (dbt_cloud.yml or web)
int64 timeout_duration_ms = 7
duration until timeout in milliseconds
string correlation_id = 8
identifier to correlate related registration events (matches RegisterClicked)
message
vscode.proto:554In vscode, extensions cannot automatically open external URLs Instead, vscode shows the user a modal with the URL The user can pick Open, Trust Domain, Copy, or Cancel Open or Trust Domain result in the URL opening, and url_opened will be true Cancel or Copy result in url_opened false If the user copied the URL, they may paste it into a browser to continue registration
optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string event_id = 5
UUID to uniquely identify the event
bool url_opened = 6
whether the user opened the URL (Open/Trust = true, Cancel/Copy = false)
bool oauth_params_included = 7
whether oauth parameters were included in the URL
string correlation_id = 8
identifier to correlate related registration events (matches RegisterClicked)
message
vscode.proto:231optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
message
vscode.proto:906Emitted every time a trial-light gate fires for a user (CTA impression or action denial).
optional enrichment = 1
optional editor = 2
optional user = 3
string dbt_local_cookie_user_id = 4
the anonymous user id stored at ~/.dbt/.user.yml
string event_id = 5
UUID to uniquely identify the event
string target = 6
UI surface where the gate fired; reuses RegistrationTarget vocabulary (e.g. "compare_cta", "catalog_cta", "column_lineage_cta", "rename_cta").
fields.vscode_types.UserState user_state = 7
User state at the moment the gate fired.
fields.vscode_types.TrialLightGateKind gate_kind = 8
Whether this was a passive impression or an active block.
message
vscode.proto:270optional enrichment = 1
optional editor = 2
optional user = 3
string selected_command = 4
the command that the user selected
string dbt_local_cookie_user_id = 5
the anonymous user id stored at ~/.dbt/.user.yml
message
vscode.proto:143optional enrichment = 1
optional editor = 2
optional user = 3
fields.vscode_types.UserState changed_to_state = 4
the state the user changed to
string dbt_local_cookie_user_id = 5
the anonymous user id stored at ~/.dbt/.user.yml