Skip to content
This repository was archived by the owner on Sep 30, 2024. It is now read-only.

Commit d791d4e

Browse files
committed
update doc
1 parent 4e276de commit d791d4e

1 file changed

Lines changed: 3 additions & 1 deletion

File tree

  • doc/dev/background-information/telemetry

doc/dev/background-information/telemetry/index.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,8 @@ There are two core attributes in events that are considered potentially sensitiv
9494
- Certain events may be allowlisted to have this field exported - this is defined in [`internal/telemetry/sensitiviemetadataallowlist`](https://github.com/sourcegraph/sourcegraph/blob/main/internal/telemetry/sensitivemetadataallowlist/sensitiviemetadataallowlist.go). Adding events to this list requires review and approval from Legal.
9595
- `marketingTracking`: this field tracks a lot of properties around URLs visited and marketing tracking that may contain sensitive data. This is only exported from the [Sourcegraph.com](https://sourcegraph.com/search) instance.
9696

97+
A detailed schema is available in [the Telemetry Gateway protocol documentation](./schema.md), which also has more details about what kind of data gets exported and what components are generally pruned.
98+
9799
### Exported event schema
98100

99101
The full event schema is intentionally a significant superset from the shape of the [event-recording APIs](#recording-events).
@@ -114,7 +116,7 @@ The full event schema that ends up getting exported is defined in [`telemetrygat
114116
}
115117
```
116118

117-
A detailed schema is available in [the protocol documentation](./schema.md).
119+
A detailed schema is available in [the Telemetry Gateway protocol documentation](./schema.md), which also has more details about what kind of data gets exported and what components are generally pruned - also see [sensitive attributes](#sensitive-attributes) above.
118120

119121
> NOTE: In the Sourcegraph application, the new events being exported using `internal/telemetry` are sometimes loosely referred to as "V2", as it supersedes the existing mechanisms of writing directly to the `event_logs` database table.
120122
> The *Telemetry Gateway* schema, however, is `telemetrygateway/v1`, as it is the first iteration of the service's API.

0 commit comments

Comments
 (0)