1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
# -*- mode: yaml; tab-width: 2; indent-tabs-mode: nil; -*-
# AUTOGENERATED BY ./scripts/codegen.py. DO NOT EDIT.
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/.
---
$schema: moz://mozilla.org/schemas/glean/metrics/2-0-0
$tags:
- "Toolkit :: Gecko Trace"
gecko_trace:
traces_data:
type: object
description: >
Represents the telemetry traces data collected during browser operation. This data
provides insights into errors that occur in Firefox during runtime.
Based on the [TracesData OTLP](1) protobuf definition which provides a standardized
format for collecting and transmitting trace information.
[1]: https://github.com/open-telemetry/opentelemetry-proto/blob/c0a98a1847d3124ac5f9ecd02d0e2d2732bbb590/opentelemetry/proto/trace/v1/trace.proto#L38
send_in_pings:
- traces
notification_emails:
- mvanstraten@mozilla.com
bugs:
- https://bugzilla.mozilla.org/show_bug.cgi?id=1930954
data_reviews:
- https://bugzilla.mozilla.org/show_bug.cgi?id=1930954
expires: never
# This is currently not transmitted over telemetry and thus useless for us
# version: 0.1
structure:
type: object
properties:
version:
type: string
resource_spans:
type: array
items:
type: object
properties:
# A resource represents the entity producing telemetry data, identified by a set
# of resource attributes.
#
# For example, a gecko process producing traces in Firefox has a process ID and
# a process type (e.g., ContentChild). The opentelemetry-cpp library additionally
# enforces four extra resource attributes which are listed below. These attributes
# help identify the source and context of the telemetry data.
#
# For more information, see:
# https://opentelemetry.io/docs/concepts/resources/
resource:
type: object
properties:
attributes:
type: object
properties:
gecko.process.internal_id:
type: number
gecko.process.type:
type: string
service.name:
type: string
telemetry.sdk.language:
type: string
telemetry.sdk.name:
type: string
telemetry.sdk.version:
type: string
scope_spans:
type: array
items:
type: object
properties:
# Instrumentation scope represents a logical unit within the application code with
# which the emitted telemetry can be associated. This helps in organizing and
# categorizing telemetry data based on its origin within the codebase.
#
# For more information, see:
# https://opentelemetry.io/docs/concepts/instrumentation-scope/
scope:
type: object
properties:
name:
type: string
# A list of Spans that originate from an instrumentation scope. Spans represent
# individual operations or units of work within a trace and contain timing,
# metadata, and event information about these operations.
#
# For more information, see:
# https://opentelemetry.io/docs/concepts/signals/traces/#spans
spans:
type: array
items:
type: object
properties:
# A unique identifier for a trace. All spans from the same trace share
# the same `trace_id`, allowing related spans to be grouped together
# and analyzed as a single transaction or operation flow.
trace_id:
type: string
# A unique identifier for a span within a trace. This ID distinguishes
# each span from others within the same trace.
span_id:
type: string
# The `span_id` of this span's parent span. This establishes the
# hierarchical relationship between spans, creating a tree structure
# that represents the execution path.
parent_span_id:
type: string
# A human-readable description of the operation represented by this span.
name:
type: string
start_time_unix_nano:
type: number
end_time_unix_nano:
type: number
# Events are time-stamped annotations within a span that mark significant
# moments or state changes during the span's lifetime.
events:
type: array
items:
type: object
properties:
name:
type: string
# The time the event occurred.
time_unix_nano:
type: number
# A collection of attribute key/value pairs associated with the event.
# These attributes provide detailed information about the event's
# context, parameters, and results.
#
# New attribute key/value pairs can be defined in gecko-trace.yaml
# files.
attributes:
type: object
properties:
# Generated from: toolkit/components/gecko-trace/gecko-trace.yaml:11:4
source.file:
type: string
source.line:
type: number
# Generated from: dom/quota/gecko-trace.yaml:3:4
frame_id:
type: string
result:
type: string
severity:
type: string
|
