Copy as Markdown
Other Tools
- - AbortMessage
- description: 'Message passed to NS_DebugBreak().
'
scope: report
type: string
- - Accessibility
- description: 'Set to "Active" by the accessibility service when it is active.
'
scope: report
type: string
- - AccessibilityClient
- description: 'Accessibility client ID.
'
scope: report
type: string
- - AccessibilityInProcClient
- description: 'Hexadecimal mask of in-process accessibility consumers, see accessible/windows/msaa/Compatibility.h
for the mappings.
'
scope: report
type: string
- - AdapterDeviceID
- description: 'Graphics adapter name.
'
scope: report
type: string
- - AdapterDriverVendor
- description: 'Graphics adapter driver vendor.
'
scope: report
type: string
- - AdapterDriverVersion
- description: 'Graphics adapter driver version.
'
scope: report
type: string
- - AdapterSubsysID
- description: 'Graphics adapter subsystem ID.
'
scope: report
type: string
- - AdapterVendorID
- description: 'Graphics adapter vendor name.
'
scope: report
type: string
- - additional_minidumps
- description: 'Comma separated list of additional minidumps for this crash, each
element in the list represent the suffix used in the dump filename. E.g. the
"browser" entry for crash fa909194-737b-4b93-b8da-da110ac785e0 implies the existence
of the fa909194-737b-4b93-b8da-da110ac785e0-browser.dmp file.
'
scope: report
type: string
- - Addons
- altname: Add-ons
description: 'List of currently enabled add-ons.
'
scope: report
type: string
- - Android_Board
- description: 'The name of the underlying board used by the Android device. e.g.
"k68v1_64"
'
scope: report
type: string
- - Android_Brand
- description: 'The consumer-visible brand associated with this Android device.
e.g. "vivo"
'
scope: report
type: string
- - Android_CPU_ABI
- description: 'The Android primary CPU ABI being used. e.g. "arm64-v8a"
'
scope: report
type: string
- - Android_CPU_ABI2
- description: 'The Android secondary CPU ABI being used. e.g. "armeabi-v7a"
'
scope: report
type: string
- - Android_Device
- description: 'Android device name. e.g. "1907"
'
scope: report
type: string
- - Android_Display
- description: 'End-user visible display name of the build id for the Android build.
e.g. "SP1A.210812.003 release-keys"
'
scope: report
type: string
- - Android_Fingerprint
- description: 'A string that uniquely identifies the Android build. e.g. "vivo/1907/1907:12/SP1A.210812.003/compiler03091510:user/release-keys"
'
scope: report
type: string
- - Android_Hardware
- description: 'The name of the Android hardware from "/proc". e.g. "mt6768"
'
scope: report
type: string
- - Android_Manufacturer
- description: 'Android device manufacturer. e.g. "vivo"
'
scope: report
type: string
- - Android_Model
- description: 'End-user visible Android device model name. e.g. "vivo 1907"
'
scope: report
type: string
- - Android_PackageName
- description: 'The package name of an Android application that uniquely identifies
the application on the device, Google Play Store, and third-party Android stores.
e.g. "com.example.referencebrowser"
'
scope: report
type: string
- - Android_ProcessName
- description: 'The name of the process which sent the crash report in the Android
application.
'
scope: report
type: string
- - Android_Version
- description: 'The developer preview revision of a prerelease SDK plus The current
development codename, or the string "REL" if this is a release build. e.g. "31
(REL)"
'
scope: report
type: string
- - AndroidComponentVersion
- description: 'The version of android-components in use.
'
scope: report
type: string
- - AppInitDLLs
- description: 'List of DLLs loaded when launching any application on Windows, this
reflects the contents of the AppInit_DLLs registry key.
'
scope: report
type: string
- - ApplicationBuildID
- description: 'Product application''s build ID.
'
glean:
metric: crash.app_build
type: string
scope: ping
type: string
- - ApplicationServicesVersion
- description: The version of Application Services libraries.
scope: report
type: string
- - AsyncShutdownTimeout
- description: 'This annotation is present if a shutdown blocker was not released
in time and the browser was crashed instead of waiting for shutdown to finish.
The condition that caused the hang is contained in the annotation.
'
glean:
metric: crash.async_shutdown_timeout
structure:
properties:
broken_add_blockers:
items:
type: string
type: array
conditions:
type: string
phase:
type: string
type: object
type: object
scope: ping
type: string
- - AvailablePageFile
- description: "Available commit-space in bytes. - Under Windows, computed from\
\ the PERFORMANCE_INFORMATION structure by substracting\n the CommitTotal field\
\ from the CommitLimit field.\n- Under Linux, computed from /proc/meminfo's\
\ CommitLimit - Committed_AS. Note that\n the kernel is not guaranteed to enforce\
\ that CommittedLimit >= Committed_AS. If\n Committed_AS > CommittedLimit,\
\ this value is set to 0.\n- Not available on other platforms.\n"
glean:
metric: memory.available_commit
type: quantity
unit: bytes
scope: ping
type: usize
- - AvailablePhysicalMemory
- description: 'Amount of free physical memory in bytes. - Under Windows, populated
with the contents of the MEMORYSTATUSEX''s structure ullAvailPhys field. - Under
macOS, populated with vm_statistics64_data_t::free_count. - Under Linux, populated
with /proc/meminfo''s MemFree. - Not available on other platforms.
'
glean:
metric: memory.available_physical
type: quantity
unit: bytes
scope: ping
type: usize
- - AvailableSwapMemory
- description: "Amount of free swap space in bytes. - Under macOS, populated with\
\ the contents of\n sysctl \"vm.swapusage\" :: xsu_avail.\n- Under Linux, populated\
\ with /proc/meminfo's SwapFree. - Not available on other platforms.\n"
glean:
metric: memory.available_swap
type: quantity
unit: bytes
scope: ping
type: usize
- - AvailableVirtualMemory
- description: 'Amount of free virtual memory in bytes - Under Windows, populated
with the contents of the MEMORYSTATUSEX''s structure ullAvailVirtual field.
- Under Linux, populated with /proc/meminfo''s MemAvailable. - Not available
on other platforms. - For macOS, see AvailableSwapMemory, AvailablePhysicalMemory
and PurgeablePhysicalMemory.
'
glean:
metric: memory.available_virtual
type: quantity
unit: bytes
scope: ping
type: usize
- - BackgroundTaskMode
- description: 'True if the app was invoked in background task mode via `--backgroundtask
...`, false otherwise.
'
scope: report
type: boolean
- - BackgroundTaskName
- description: 'If the app was invoked in background task mode via `--backgroundtask
<task name>`, the string "task name".
'
glean:
metric: crash.background_task_name
type: string
scope: ping
type: string
- - BlockedDllList
- description: 'Semicolon-separated list of blocked DLLS, Windows-only
'
glean:
delimiter: ;
metric: dll_blocklist.list
type: string_list
scope: ping
type: string
- - BlocklistInitFailed
- description: 'Set to 1 if the DLL blocklist could not be initialized.
'
glean:
metric: dll_blocklist.init_failed
type: boolean
scope: ping
skip_if: '0'
type: boolean
- - Breadcrumbs
- description: 'Trail of events that occurred before a report. this will consist
of multiple breadcrumbs with timestamp, message, category, level, type and data
in JSON format.
'
scope: report
type: string
- - BuildID
- description: 'Application build ID, the format is YYYYMMDDHHMMSS.
'
glean:
metric: crash.build_id
type: string
scope: ping
type: string
- - Comments
- description: 'The user comments for a crash, recorded by the crash reporter client.
'
scope: report
type: string
- - ContentSandboxCapabilities
- description: 'List of capabilities of the content process sandbox.
'
scope: report
type: u32
- - ContentSandboxCapable
- description: 'Set to 1 if the client is capable of content sandboxing.
'
scope: report
type: boolean
- - ContentSandboxEnabled
- description: 'Set to 1 when content process sandboxing is enabled.
'
scope: report
type: boolean
- - ContentSandboxLevel
- description: 'Content sandbox level.
'
scope: report
type: u32
- - ContentSandboxWin32kState
- description: 'Content sandbox Win32k state
'
scope: report
type: string
- - CPUMicrocodeVersion
- description: 'Version of the CPU microcode.
'
scope: report
type: string
- - CrashTime
- description: 'Crash time in seconds since the Epoch.
'
glean:
metric: crash.time
time_unit: second
type: datetime
scope: ping
type: string
- - CrashType
- description: The type of crash that occurred (Android-only).
glean:
metric: crash.crash_type
type: string
scope: ping
type: string
- - CycleCollector
- description: 'Reason why the cycle collector crashed.
'
scope: report
type: string
- - DesktopEnvironment
- description: 'Desktop environment used on Linux, e.g. GNOME, KDE, XFCE, etc.
'
scope: report
type: string
- - DeviceResetReason
- description: 'Reason why a DirectX device has been reset, Windows only.
'
scope: report
type: u32
- - DistributionID
- description: The distribution ID of the application.
scope: report
type: string
- - DOMFissionEnabled
- description: 'Set to 1 when DOM fission is enabled, and subframes are potentially
loaded in a separate process.
'
glean:
metric: crash.dom_fission_enabled
type: boolean
scope: ping
type: boolean
- - DOMIPCEnabled
- description: 'Set to 1 when a tab is running in a content process
'
scope: report
type: boolean
- - DumperError
- description: 'Error message of the minidump writer, in case there was an error
during dumping.
'
scope: report
type: string
- - EMCheckCompatibility
- description: 'Set to true if add-on compatibility checking is enabled. Technically
this annotation should be a boolean, but historically it''s been set by JavaScript
code as a string, so keep it as such for the time being.
'
scope: report
type: string
- - EventLoopNestingLevel
- description: 'Present only if higher than 0, indicates that we''re running in
a nested event loop and indicates the nesting level.
'
glean:
metric: crash.event_loop_nesting_level
type: quantity
unit: levels
scope: ping
skip_if: '0'
type: u32
- - FontName
- description: 'Set before attempting to load a font to help diagnose crashes during
loading.
'
glean:
metric: crash.font_name
type: string
scope: ping
type: string
- - GeckoViewVersion
- description: The version of geckoview in use.
scope: report
type: string
- - GleanVersion
- description: The version of Glean in use.
scope: report
type: string
- - GMPLibraryPath
- description: 'Holds the path to the GMP plugin library.
'
scope: report
type: string
- - GMPPlugin
- description: 'Set to 1 if the GMP plugin is enabled.
'
scope: report
type: boolean
- - GPUProcessLaunchCount
- description: 'Number of times the GPU process was launched.
'
glean:
metric: crash.gpu_process_launch
type: quantity
unit: events
scope: ping
type: u32
- - GPUProcessStatus
- description: 'Status of the GPU process, can be set to "Running" or "Destroyed"
'
scope: report
type: string
- - GpuSandboxLevel
- description: 'GPU sandbox level.
'
scope: report
type: u32
- - GraphicsCompileShader
- description: 'Name of the shader we are in the process of compiling, if applicable.
See file names in gfx/wr/webrender/res/* for the possible values.
'
scope: report
type: string
- - GraphicsCriticalError
- description: 'Information of a critical error that occurred within the graphics
code.
'
scope: report
type: string
- - GraphicsDrawShader
- description: 'Name of the shader that is currently bound for a draw call, if applicable.
See file names in gfx/wr/webrender/res/* for the possible values.
'
scope: report
type: string
- - GraphicsFontFile
- description: 'Error and path of the font file that has failed to load. The user''s
profile dir is removed from the front of the path if necessary.
'
scope: report
type: string
- - GraphicsNumActiveRenderers
- description: 'Number of webrender renderer instances that are not in a paused
state.
'
scope: report
type: usize
- - GraphicsNumRenderers
- description: 'Total number of webrender renderer instances.
'
scope: report
type: usize
- - GraphicsStartupTest
- description: 'Set to 1 by the graphics driver crash guard when it''s activated.
'
scope: report
type: boolean
- - Hang
- description: 'Set if the crash was the result of a hang, with a value which describes
the type of hang (e.g. "ui" or "shutdown").
'
glean:
metric: crash.hang
type: string
scope: ping
type: string
- - HasDeviceTouchScreen
- description: 'Set to 1 if the device had a touch-screen, this only applies to
Firefox desktop as on mobile devices we assume a touch-screen is always present.
'
scope: report
type: boolean
- - HeadlessMode
- description: 'True if the app was invoked in headless mode via `--headless ...`
or `--backgroundtask ...`, false otherwise.
'
glean:
metric: environment.headless_mode
type: boolean
scope: ping
type: boolean
- - InstallTime
- description: 'The time when Firefox was installed expressed as seconds since the
Epoch
'
scope: report
type: string
- - ipc_channel_error
- description: 'Set before a content process crashes because of an IPC channel error.
Holds a description of the error.
'
glean:
metric: crash.ipc_channel_error
type: string
scope: ping
type: string
- - IpcCreatePipeCloExecErrno
- description: 'errno value retrieved after failing to set the O_CLOEXEC flag on
a pipe used for IPC.
'
scope: report
type: u32
- - IpcCreatePipeFcntlErrno
- description: 'errno value retrieved after a call to fcntl() on a pipe used for
IPC failed.
'
scope: report
type: u32
- - IpcCreatePipeSocketPairErrno
- description: 'errno value retrieved after a socketpair() call failed while creating
an IPC transport object.
'
scope: report
type: u32
- - IPCFatalErrorMsg
- description: 'Describes a fatal error that occurred during IPC operation.
'
scope: report
type: string
- - IPCFatalErrorProtocol
- description: 'Name of the protocol used by IPC when a fatal error occurred.
'
scope: report
type: string
- - IPCMessageLargeBufferShmemFailureSize
- description: 'Size of failed shmem allocations which led to data being sent inline
in the IPC message that caused a crash because it was too large.
'
scope: report
type: u32
- - IPCMessageName
- description: 'Name of the IPC message that caused a crash because it was too large.
'
scope: report
type: string
- - IPCMessageSize
- description: 'Size of the IPC message that caused a crash because it was too large.
'
scope: report
type: u32
- - IPCReadErrorReason
- description: 'Reason why reading an object via IPC failed.
'
scope: report
type: string
- - IPCShutdownState
- description: 'IPC shutdown state, can be set to either "RecvShutdown" or "SendFinishShutdown"
by a content process while it''s shutting down.
'
scope: report
type: string
- - IPCSystemError
- description: 'Description of the last system error that occurred during IPC operation.
'
scope: report
type: u32
- - IsGarbageCollecting
- description: 'If true then the JavaScript garbage collector was running when the
crash occurred.
'
glean:
metric: crash.is_garbage_collecting
type: boolean
scope: ping
skip_if: '0'
type: boolean
- - IsWayland
- description: 'If true then the Wayland windowing system was in use.
'
scope: report
type: boolean
- - IsWebRenderResourcePathOverridden
- description: 'If true then the WebRender resources (i.e. shaders) are loaded from
a user specified path.
'
scope: report
type: boolean
- - JavaException
- description: 'JSON structured Java stack trace, only present on Firefox for Android
if we encounter an uncaught Java exception.
'
glean:
metric: crash.java_exception
structure:
properties:
throwables:
items:
properties:
message:
type: string
stack:
items:
properties:
class_name:
type: string
file:
type: string
is_native:
type: boolean
line:
type: number
method_name:
type: string
type: object
type: array
type_name:
type: string
type: object
type: array
type: object
type: object
version: 1
scope: ping
type: string
- - JavaStackTrace
- description: 'Java stack trace, only present on Firefox for Android if we encounter
an uncaught Java exception.
'
scope: report
type: string
- - JSActorMessage
- description: 'If an actor is currently treating a message, this is the name of
the message. Otherwise, empty.
'
scope: report
type: string
- - JSActorName
- description: 'If an actor is currently treating a message, this is the name of
the actor. Otherwise, empty.
'
scope: report
type: string
- - JSLargeAllocationFailure
- description: 'A large allocation couldn''t be satisfied, check the JSOutOfMemory
description for the possible values of this annotation.
'
glean:
metric: memory.js_large_allocation_failure
type: string
scope: ping
type: string
- - JSModuleLoadError
- description: 'The error raised when attempting to import a critical JS module
from C++
'
scope: report
type: string
- - JSOutOfMemory
- description: 'A small allocation couldn''t be satisfied, the annotation may contain
the "Reporting", "Reported" or "Recovered" value. The first one means that we
crashed while responding to the OOM condition (possibly while running a memory-pressure
observers), the second that we crashed after having tried to free some memory,
and the last that the GC had managed to free enough memory to satisfy the allocation.
'
glean:
metric: memory.js_out_of_memory
type: string
scope: ping
type: string
- - LastInteractionDuration
- description: 'How long the user had been inactive in seconds if the user was inactive
at crash. The value is not set if the user state was active.
'
glean:
custom_convert: duration_seconds
metric: crash.last_interaction_duration
time_unit: second
type: timespan
scope: ping
type: u64
- - LastStartupWasCrash
- description: 'True if the last startup was detected to have been a crash.
'
scope: report
type: boolean
- - LauncherProcessState
- description: 'Launcher process enabled state. The integer value of this annotation
must match with one of the values in the mozilla::LauncherRegistryInfo::EnableState
enum
'
scope: report
type: u32
- - LinuxMemoryPSI
- description: 'Memory PSI (Pressure Stall Information) values from /proc/pressure/memory
as comma-separated list: some_avg10,some_avg60,some_avg300,some_total,full_avg10,full_avg60,full_avg300,full_total
'
glean:
metric: crash.linux_memory_psi
type: string
scope: ping
type: string
- - LinuxUnderMemoryPressure
- description: 'Set to true if the memory pressure watcher was under memory pressure
when the crash occurred.
'
scope: report
type: boolean
- - LowPhysicalMemoryEvents
- description: 'Number of times the available memory tracker has detected that free
physical memory is running low. This is a Windows-specific annotation.
'
glean:
metric: memory.low_physical
type: quantity
unit: events
scope: ping
skip_if: '0'
type: u32
- - MacAvailableMemorySysctl
- description: 'The value of the available memory sysctl ''kern.memorystatus_level''.
Expected to be a percentage integer value.
'
scope: report
type: u32
- - MacMemoryPressure
- description: 'The current memory pressure state as provided by the macOS memory
pressure dispatch source. The annotation value is one of "Normal" for no memory
pressure, "Unset" indicating a memory pressure event has not been received,
"Warning" or "Critical" mapping to the system memory pressure levels, or "Unexpected"
for an unexpected level. This is a Mac-specific annotation.
'
scope: report
type: string
- - MacMemoryPressureCriticalTime
- description: 'The time when the memory pressure state last transitioned to ''Critical''
expressed as seconds since the Epoch.
'
scope: report
type: string
- - MacMemoryPressureNormalTime
- description: 'The time when the memory pressure state last transitioned to ''Normal''
expressed as seconds since the Epoch.
'
scope: report
type: string
- - MacMemoryPressureSysctl
- description: 'The value of the memory pressure sysctl ''kern.memorystatus_vm_pressure_level''.
Indicates which memory pressure level the system is in at the time of the crash.
The expected values are one of 4 (Critical), 2 (Warning), or 1 (Normal).
'
scope: report
type: u32
- - MacMemoryPressureWarningTime
- description: 'The time when the memory pressure state last transitioned to ''Warning''
expressed as seconds since the Epoch.
'
scope: report
type: string
- - MainThreadRunnableName
- description: 'Name of the currently executing nsIRunnable on the main thread.
'
glean:
metric: crash.main_thread_runnable_name
type: string
scope: ping
type: string
- - Marionette
- description: 'Set to 1 when Marionette (WebDriver Classic) is enabled.
'
scope: report
type: boolean
- - MemtestOutput
- description: 'The output of memory tests done by the crash reporter client after
a crash in a JSON format
'
scope: report
type: string
- - MinidumpSha256Hash
- description: 'The sha256 hash of the minidump file, if available.
'
glean:
metric: crash.minidump_sha_256_hash
type: string
scope: ping
type: string
- - ModuleSignatureInfo
- description: 'A string holding a JSON object describing which entity signed the
modules present in the system. The format of this object is: { "Vendor1": [
"Module1", "Module2", ...], "Vendor2": [ "Module3", ... ] }
'
scope: report
type: string
- - MozCrashReason
- description: 'Plaintext description of why Firefox crashed, this is usually set
by assertions and the like.
'
glean:
metric: crash.moz_crash_reason
type: string
scope: ping
type: string
- - NimbusEnrollments
- description: 'A comma-separated string that specifies the active Nimbus experiments
and rollouts, as well as their branches.
'
glean:
delimiter: ','
metric: environment.nimbus_enrollments
type: string_list
scope: ping
type: string
- - Notes
- description: 'Miscellaneous notes that can be appended to a crash.
'
scope: report
type: string
- - OOMAllocationSize
- description: 'Size of the allocation that caused an out-of-memory condition.
'
glean:
metric: memory.oom_allocation_size
type: quantity
unit: bytes
scope: ping
skip_if: '0'
type: usize
- - PHCAllocStack
- description: 'The allocation''s allocation stack trace, if the crash involved
a bad access of a special PHC allocation. Encoded as a comma-separated list
of decimal addresses.
'
scope: report
type: string
- - PHCBaseAddress
- description: 'The allocation''s base address, if the crash involved a bad access
of a special PHC allocation. Encoded as a decimal address.
'
scope: report
type: string
- - PHCFreeStack
- description: 'The allocation''s free stack trace, if the crash involved a bad
access of a special PHC allocation. Encoded as a comma-separated list of decimal
addresses.
'
scope: report
type: string
- - PHCKind
- description: 'The allocation kind, if the crash involved a bad access of a special
PHC allocation.
'
scope: report
type: string
- - PHCUsableSize
- description: 'The allocation''s usable size, if the crash involved a bad access
of a special PHC allocation.
'
scope: report
type: u32
- - PluginFilename
- description: 'Plugin filename, only the process holding the plugin has this annotation.
'
scope: report
type: string
- - PluginName
- description: 'Display name of a plugin, only the process holding the plugin has
this annotation.
'
scope: report
type: string
- - PluginVersion
- description: 'Version of a plugin, only the process holding the plugin has this
annotation.
'
scope: report
type: string
- - ProcessType
- description: 'Type of the process that crashed, the possible values are defined
in GeckoProcessTypes.h.
'
glean:
metric: crash.process_type
type: string
scope: ping
type: string
- - ProductID
- description: 'Application UUID (e.g. ec8030f7-c20a-464f-9b0e-13a3a9e97384).
'
glean:
metric: crash.product_id
type: string
scope: ping
type: string
- - ProductName
- description: 'Application name (e.g. Firefox).
'
glean:
metric: crash.product_name
type: string
scope: ping
type: string
- - ProfileDirectory
- description: 'The directory of the active profile, if any.
'
scope: client
type: string
- - ProfilerChildShutdownPhase
- description: 'When a child process shuts down, this describes if the profiler
is running, and the point the profiler shutdown sequence has reached.
'
glean:
metric: crash.profiler_child_shutdown_phase
type: string
scope: ping
type: string
- - PurgeablePhysicalMemory
- description: 'macOS only. Amount of physical memory currently allocated but which
may be deallocated by the system in case of memory pressure. Populated from
vm_statistics64_data_t::purgeable_count * vm_page_size.
'
glean:
metric: memory.purgeable_physical
type: quantity
unit: bytes
scope: ping
type: usize
- - QuotaManagerShutdownTimeout
- description: 'This annotation is present if the quota manager shutdown (resp.
the shutdown of the quota manager clients) was not finished in time and the
browser was crashed instead of waiting for the shutdown to finish. The status
of objects which were blocking completion of the shutdown when reaching the
timeout is contained in the annotation.
In the case of IndexedDB, objects are divided into three groups: FactoryOperations,
LiveDatabases and DatabaseMaintenances.
In the case of LocalStorage, objects are divided into three groups: PrepareDatastoreOperations,
Datastores and LiveDatabases.
In the case of Cache API, objects are in one group only: Managers.
Each group is reported separately and contains the number of objects in the
group and the status of individual objects in the group (duplicate entries are
removed): "GroupName: N (objectStatus1, objectStatus2, ...)" where N is the
number of objects in the group.
The status of individual objects is constructed by taking selected object properties.
Properties which contain origin strings are anonymized.
In addition, intermediate steps are recorded for change events after shutdown
started. These include the time difference and the type of object.
'
glean:
metric: crash.quota_manager_shutdown_timeout
structure:
items:
type: string
type: array
type: object
scope: ping
type: string
- - QuotaManagerStorageIsNetworkResource
- description: 'On Windows, this indicates if QM''s base dir lives on a network
resource. It is the direct result of the Win32 API function PathIsNetworkPath.
'
scope: report
type: boolean
- - RDDProcessStatus
- description: 'Status of the RDD process, can be set to "Running" or "Destroyed"
'
scope: report
type: string
- - ReleaseChannel
- description: 'Application release channel (e.g. default, beta, ...)
'
glean:
metric: crash.app_channel
type: string
scope: ping
type: string
- - RemoteAgent
- description: 'Set to 1 when the Remote Agent (WebDriver BiDi) is enabled.
'
scope: report
type: boolean
- - RemoteType
- description: 'Type of the content process, can be set to "web", "file" or "extension".
'
glean:
metric: crash.remote_type
type: string
scope: ping
type: string
- - SafeMode
- description: 'Set to 1 if the browser was started in safe mode.
'
scope: report
type: boolean
- - SecondsSinceLastCrash
- description: 'Time in seconds since the last crash occurred.
'
glean:
custom_convert: duration_seconds
metric: crash.time_since_last_crash
time_unit: second
type: timespan
scope: ping
type: u64
- - ServerURL
- description: 'URL used to post the crash report.
'
scope: client
type: string
- - ShutdownProgress
- description: 'Shutdown step at which the browser crashed, can be set to "quit-application",
"profile-change-teardown", "profile-before-change", "xpcom-will-shutdown" or
"xpcom-shutdown".
'
glean:
metric: crash.shutdown_progress
type: string
scope: ping
type: string
- - ShutdownReason
- description: 'One out of "Unknown", "AppClose", "AppRestart", "OSForceClose",
"OSSessionEnd" or "OSShutdown".
'
glean:
metric: crash.shutdown_reason
type: string
scope: ping
type: string
- - StackTraces
- description: 'Stack traces extracted from the crash minidump, if available. These
are sent in pings, however they are extracted and transformed into a different
format. The field in the extra file is meant only for client use.
'
glean:
metric: crash.stack_traces
structure:
properties:
crash_address:
type: string
crash_thread:
type: number
crash_type:
type: string
error:
type: string
main_module:
type: number
modules:
items:
properties:
base_address:
type: string
code_id:
type: string
debug_file:
type: string
debug_id:
type: string
end_address:
type: string
filename:
type: string
version:
type: string
type: object
type: array
threads:
items:
properties:
frames:
items:
properties:
ip:
type: string
module_index:
type: number
trust:
type: string
type: object
type: array
type: object
type: array
type: object
type: object
scope: ping-only
type: object
- - StartupCacheValid
- description: 'True if the startup cache was deemed valid and usable. Will be false
if the last session used a different browser version or had a startup cache.
'
scope: report
type: boolean
- - StartupCrash
- description: 'If set to 1 then this crash occurred during startup.
'
glean:
metric: crash.startup
type: boolean
scope: ping
type: boolean
- - StartupTime
- description: 'The time when Firefox was launched expressed in seconds since the
Epoch.
'
scope: report
type: u64
- - StorageConnectionNotClosed
- description: 'This annotation is added when a mozStorage connection has not been
properly closed during shutdown. The annotation holds the filename of the database
associated with the connection.
'
scope: report
type: string
- - SubmittedFrom
- description: 'This annotation can hold one of the following five values depending
on how this crash was submitted by the user: * Auto: the user had opted-in to
auto-submission * Infobar: the user clicked on the infobar to submit the crash
* AboutCrashes: the user sent the crash from the about:crashes page * CrashedTab:
the user sent the crash from a crashed tab page * Client: the user sent the
crash using the crash reporter client
'
scope: report
type: string
- - SystemMemoryUsePercentage
- description: 'Windows-only, percentage of physical memory in use. This annotation
is populated with the contents of the MEMORYSTATUSEX''s structure dwMemoryLoad
field.
'
glean:
metric: memory.system_use_percentage
type: quantity
unit: percent
scope: ping
type: u32
- - TelemetryClientId
- description: 'Telemetry client ID.
'
scope: client
type: string
- - TelemetryEnvironment
- description: 'The telemetry environment in JSON format.
'
scope: report
type: string
- - TelemetryProfileGroupId
- description: 'Telemetry profile group ID.
'
scope: client
type: string
- - TelemetryServerURL
- description: 'Telemetry server URL. Used to send main process crash pings directly
from the crashreporter client.
'
scope: client
type: string
- - TelemetrySessionId
- description: 'Telemetry session ID.
'
scope: client
type: string
- - TestBoolean
- description: 'Annotation used in tests.
'
scope: report
type: boolean
- - TestInteger
- description: 'Annotation used in tests.
'
scope: report
type: u32
- - TestKey
- description: 'Annotation used in tests.
'
scope: report
type: string
- - TestUnicode
- description: 'Annotation used in tests.
'
scope: report
type: string
- - TextureUsage
- description: 'Amount of memory in bytes consumed by textures.
'
glean:
metric: memory.texture
type: quantity
unit: bytes
scope: ping
skip_if: '0'
type: usize
- - Throttleable
- description: 'Whether Socorro can selectively discard this crash report or not.
If set to "0" the crash report will always be processed by Socorro. Do not set
this annotation within Gecko code, it''s only supposed to be used by the crash
reporting machinery.
'
scope: report
type: boolean
- - TotalPageFile
- description: "Maximum amount of memory that can be committed without extending\
\ the swap/page file. - Under Windows, populated with the contents of the PERFORMANCE_INFORMATION's\n\
\ structure CommitLimit field.\n- Under Linux, populated with /proc/meminfo\
\ MemTotal + SwapTotal. The swap file\n typically cannot be extended, so that's\
\ a hard limit.\n- Not available on other systems.\n"
glean:
metric: memory.total_page_file
type: quantity
unit: bytes
scope: ping
type: usize
- - TotalPhysicalMemory
- description: 'Amount of physical memory in bytes. - Under Windows, populated with
the contents of the MEMORYSTATUSEX''s structure ullTotalPhys field. - Under
macOS, populated with sysctl "hw.memsize". - Under Linux, populated with /proc/meminfo''s
"MemTotal". - Not available on other systems.
'
glean:
metric: memory.total_physical
type: quantity
unit: bytes
scope: ping
type: usize
- - TotalVirtualMemory
- description: "Size of the virtual address space. - Under Windows, populated with\
\ the contents of the MEMORYSTATUSEX's structure\n ullTotalVirtual field.\n\
- Not available on other platforms.\n"
glean:
metric: memory.total_virtual
type: quantity
unit: bytes
scope: ping
type: usize
- - UnknownNetAddrSocketFamily
- description: 'An unknown network address family was requested to Necko. The value
is the requested family number.
'
scope: report
type: u32
- - UptimeTS
- description: 'Uptime in seconds. This annotation uses a string instead of an integer
because it has a fractional component.
'
glean:
metric: environment.uptime
time_unit: millisecond
type: timespan
scope: ping
type: string
- - URL
- description: 'URL being loaded.
'
scope: report
type: string
- - URLSegments
- description: 'The offsets of the nsStandardURL segments that fail a sanity check
'
scope: report
type: string
- - User32BeforeBlocklist
- description: 'Set to 1 if user32.dll was loaded before we could install the DLL
blocklist.
'
glean:
metric: dll_blocklist.user32_loaded_before
type: boolean
scope: ping
skip_if: '0'
type: boolean
- - useragent_locale
- description: 'User-agent locale.
'
scope: report
type: string
- - UserFontRulesExhausted
- description: 'Set to "inside" if rules exhausted while adding fonts inside the
user''s dir, set to "outside" if adding for fonts outside the user''s dir.
'
scope: report
type: string
- - UtilityActorsName
- description: 'Comma-separated list of IPC actors name running on this Utility
process instance
'
glean:
delimiter: ','
metric: crash.utility_actors_name
type: string_list
scope: ping
type: string
- - UtilityProcessStatus
- description: 'Status of the Utility process, can be set to "Running" or "Destroyed"
'
scope: report
type: string
- - Vendor
- description: 'Application vendor (e.g. Mozilla).
'
scope: report
type: string
- - Version
- description: 'Product version.
'
glean:
metric: crash.app_display_version
type: string
scope: ping
type: string
- - VRProcessStatus
- description: 'Status of the VR process, can be set to "Running" or "Destroyed"
'
scope: report
type: string
- - WasmLibrarySandboxMallocFailed
- description: 'Set to 1 if a rlbox wasm library sandbox ran out of memory, causing
a malloc inside the sandbox to fail.
'
scope: report
type: boolean
- - WindowsErrorReporting
- description: 'Set to 1 if this crash was intercepted via the Windows Error Reporting
runtime exception module.
'
glean:
metric: crash.windows.error_reporting
type: boolean
scope: ping
type: boolean
- - WindowsFileDialogErrorCode
- description: 'The HRESULT returned from a Win32 system call leading to termination
of the file-dialog utility process. MozCrashReason is expected to provide context
for the value.
'
glean:
metric: crash.windows.file_dialog_error_code
type: string
scope: ping
type: u32
- - WindowsPackageFamilyName
- description: 'If running in a Windows package context, the package family name,
per https://docs.microsoft.com/en-us/windows/win32/api/appmodel/nf-appmodel-getcurrentpackagefamilyname.
The package family name is only included when it is likely to have been produced
by Mozilla: it starts "Mozilla." or "MozillaCorporation.".
'
glean:
metric: windows.package_family_name
type: string
scope: ping
type: string
- - Winsock_LSP
- description: 'Information on winsock LSPs injected in our networking stack.
'
scope: report
type: string
- - XPCOMSpinEventLoopStack
- description: 'If we crash while some code is spinning manually the event loop
on the main thread, we will see the stack of nested annotations here. If the
crashing process was killed (e.g. due to an IPC error), this annotation may
refer to the parent process that killed it, look out for the prefix ("default"
means parent) and see bug 1741131 for details.
'
scope: report
type: string