# OotbMatch
**Source definition:** [`src/bitdrift/public/unary/workflows/v1/workflow.proto#L246-L1219`]()
| Field | Type | Description |
|---|---|---|
| generic_condition | [bitdrift.public.unary.workflows.v1.OotbMatch.GenericOotbConditionType.GenericOotbConditionType](#bitdrift.public.unary.workflows.v1.OotbMatch.GenericOotbConditionType.GenericOotbConditionType "bitdrift.public.unary.workflows.v1.OotbMatch.GenericOotbConditionType.GenericOotbConditionType")
must be a defined enum valueonly one of generic_condition, or android_condition, apple_condition can be set | A cross-platform OOTB condition that applies to all supported platforms. |
| android_condition | [bitdrift.public.unary.workflows.v1.OotbMatch.AndroidOotbConditionType.AndroidOotbConditionType](#bitdrift.public.unary.workflows.v1.OotbMatch.AndroidOotbConditionType.AndroidOotbConditionType "bitdrift.public.unary.workflows.v1.OotbMatch.AndroidOotbConditionType.AndroidOotbConditionType")
must be a defined enum valueonly one of android_condition, or generic_condition, apple_condition can be set | An Android-specific OOTB condition. |
| apple_condition | [bitdrift.public.unary.workflows.v1.OotbMatch.AppleOotbConditionType.AppleOotbConditionType](#bitdrift.public.unary.workflows.v1.OotbMatch.AppleOotbConditionType.AppleOotbConditionType "bitdrift.public.unary.workflows.v1.OotbMatch.AppleOotbConditionType.AppleOotbConditionType")
must be a defined enum valueonly one of apple_condition, or generic_condition, android_condition can be set | An Apple-specific OOTB condition. |
| generic_match | [bitdrift.public.unary.workflows.v1.GenericMatch](bitdrift_public_unary_workflows_v1_GenericMatch.md "bitdrift.public.unary.workflows.v1.GenericMatch") | Additional match conditions for this OOTB event. This is an AND in addition to the previously defined event. |
Example
```json
{
"generic_condition": "APP_LAUNCH",
"generic_match": {
"base_matcher": {
"log_field": "field_name",
"operator": "EQUAL",
"string_value": "example"
}
}
}
```
# OotbMatch.GenericOotbConditionType
**Source definition:** [`src/bitdrift/public/unary/workflows/v1/workflow.proto#L252-L1027`]()
Cross-platform OOTB condition types. These events are emitted on all supported platforms.
Where applicable, enum value documentation and metadata describe the well-known log fields
carried by that event and matchable via `generic_match`. Platform-specific enums below share
the same field definitions for values that appear here; only platform-exclusive values add
new fields.
No fields
# OotbMatch.GenericOotbConditionType.GenericOotbConditionType Enum
**Source definition:** [`src/bitdrift/public/unary/workflows/v1/workflow.proto#L253-L1026`]()
| Name | Description | Fields |
|---|---|---|
| UNKNOWN | Invalid placeholder value. Do not use. | |
| APP_BACKGROUND | App moves out of the foreground and begins backgrounding. | |
| APP_BUILT_IN_JS_FATAL_ERROR | The SDK's built-in JS error handler captures a fatal JavaScript error. | |
| APP_BUILT_IN_JS_NON_FATAL_ERROR | The SDK's built-in JS error handler captures a non-fatal JavaScript error. | |
| APP_CLOSE | App leaves the screen and its foreground UI closes. | |
| APP_FOREGROUND | App moves into the foreground and becomes active. | |
| APP_LAUNCH | App launch completes for a new process. | `startup_type` (string, Android) — COLD, WARM, or HOT.
`startup_reason` (string, Android) — Why the app was launched.
`startup_state` (string, Android) — Startup state at launch time.
`startup_launch_mode` (string, Android) — Activity launch mode.
`startup_was_forced_stopped` (string, Android) — Whether the app was previously force-stopped.
`startup_time_to_initial_display_ms` (int, ms, Android) — Time from process start to first frame, if available.
`startup_intent_action` (string, Android) — Intent action that triggered the launch, if present.
`_launch_type` (string, iOS) — Launch type (e.g., remote notification).
`_scene` (string, iOS) — Scene that is activated. |
| APP_LAUNCH_TTI | App reached time-to-interactive after launch. Carries the same fields as APP_LAUNCH. | |
| APP_OPEN | App opens into the foreground, either on a cold start or when reopened from the background. | |
| APP_TERMINATION | An app termination is recorded. On Android this includes OS-reported exit information; on Apple this corresponds to the app termination notification. | `_app_exit_reason` (string) — iOS: "app_will_terminate_notification". Android: ApplicationExitInfo reason. |
| APP_UPDATE | App updates to a new version. | |
| BATTERY_STATE_CHANGE | Device battery state changes. | `_state` (string) — Android: "charging"/"unplugged". iOS: UIDevice battery state string.
`_battery_level` (int, percent) — Battery percentage.
`_battery_val` (float) — Battery level as a float. |
| GQL_REQUEST | A GraphQL request starts. Requires supported network instrumentation so the SDK can emit the underlying HTTP and GraphQL span data. | `_method` (string) — HTTP method.
`_host` (string) — Request host.
`_path_template` (string) — Format: gql-{operation_name}.
`_operation_name` (string) — GraphQL operation name.
`_operation_type` (string) — GraphQL operation type (query/mutation/subscription).
`_operation_id` (string) — GraphQL operation ID.
`_span_id` (string) — Span identifier. |
| GQL_RESPONSE | A GraphQL response completes. Requires supported network instrumentation and carries all GQL_REQUEST fields plus response-specific fields. | `_method` (string) — HTTP method.
`_host` (string) — Request host.
`_path_template` (string) — Format: gql-{operation_name}.
`_operation_name` (string) — GraphQL operation name.
`_operation_type` (string) — GraphQL operation type (query/mutation/subscription).
`_operation_id` (string) — GraphQL operation ID.
`_status_code` (int) — HTTP status code.
`_duration_ms` (int, ms) — Round-trip duration.
`_result` (string) — "success" or "failure".
`_span_id` (string) — Span identifier. |
| LOW_POWER_MODE | Device low-power mode toggles. | `_low_power_enabled` (bool, Android) — Power save mode state.
`_low_power_mode` (bool, iOS) — Low power mode state.
`_battery_val` (float, iOS) — Battery level as a float.
`_state` (string, iOS) — Battery charging state.
`_battery_level` (int, percent, iOS) — Battery percentage. |
| MEMORY_PRESSURE | App memory pressure is recorded. On Android this is emitted when app memory usage meets the configured low-memory threshold. On Apple this is emitted for system memory pressure notifications. | `_jvm_used_kb` (int, KB, Android) — JVM heap currently used.
`_jvm_total_kb` (int, KB, Android) — JVM heap currently allocated/committed.
`_jvm_max_kb` (int, KB, Android) — JVM heap maximum size.
`_jvm_used_percent` (float, percent, Android) — JVM used as percent of max.
`_native_used_kb` (int, KB, Android) — Native heap allocated.
`_native_total_kb` (int, KB, Android) — Native heap total size.
`_memory_class` (int, MB, Android) — Per-app memory class reported by Android.
`_is_memory_low` (bool) — Whether app memory usage is at or above the configured low-memory threshold.
`_app_used_kb` (int, KB, iOS) — App physical memory footprint.
`_app_limit_kb` (int, KB, iOS) — Estimated app memory limit before termination.
`_device_kb` (int, KB, iOS) — Total device RAM.
`_app_used_percent` (float, percent, iOS) — App used memory as a percent of the estimated limit.
`_mem_level` (string, iOS) — Apple memory pressure level: normal, warning, or critical. |
| NETWORK_REQUEST | An HTTP network request starts. Requires supported network instrumentation integration. | `_method` (string) — HTTP method.
`_host` (string) — Request host.
`_path` (string) — Full request path (high cardinality).
`_path_template` (string) — Normalized path template (prefer for group_by).
`_query` (string) — Query string.
`_span_id` (string) — Span identifier.
`_request_body_bytes_expected_to_send_count` (int, bytes) — Expected request body size from Content-Length. |
| NETWORK_RESPONSE | An HTTP network response completes. Requires supported network instrumentation integration. | `_method` (string) — HTTP method.
`_host` (string) — Request host.
`_path` (string) — Full request path (high cardinality).
`_path_template` (string) — Normalized path template (prefer for group_by).
`_query` (string) — Query string.
`_status_code` (int) — HTTP status code.
`_result` (string) — "success" or "failure". Prefer over _status_code for filtering.
`_duration_ms` (int, ms) — Round-trip duration.
`_error_type` (string, Android) — Error type string (Android). iOS emits _error_code instead.
`_error_code` (int, iOS) — Numeric error code (iOS). Android emits _error_type instead.
`_error_message` (string) — Human-readable error description.
`_request_body_bytes_sent_count` (int, bytes) — Request body bytes sent.
`_response_body_bytes_received_count` (int, bytes) — Response body bytes received.
`_request_headers_bytes_count` (int, bytes) — Request header bytes.
`_response_headers_bytes_count` (int, bytes) — Response header bytes.
`_dns_resolution_duration_ms` (int, ms) — DNS lookup duration.
`_tls_duration_ms` (int, ms) — TLS handshake duration.
`_tcp_duration_ms` (int, ms) — TCP connection duration.
`_fetch_init_duration_ms` (int, ms) — Fetch initialization duration.
`_response_latency_ms` (int, ms) — Time to first response byte.
`_protocol` (string) — Protocol used (e.g., h2, http/1.1).
`_span_id` (string) — Span identifier. |
| ORIENTATION_CHANGE | Device orientation changes. | `_orientation` (string) — Android: "portrait"/"landscape". iOS: portrait, portraitUpsideDown, landscapeLeft, landscapeRight, faceUp, faceDown, unknown. |
| RESOURCE | A periodic resource snapshot. Carries device and process resource metrics such as memory, battery, power, disk, and network throughput fields. Memory, battery, and low-power fields are emitted on every snapshot; disk-usage fields are sampled at most once every 24 hours. | `_jvm_used_kb` (int, KB, Android) — JVM heap currently used. Included on every Android RESOURCE snapshot.
`_jvm_max_kb` (int, KB, Android) — JVM heap maximum size. Included on every Android RESOURCE snapshot.
`_jvm_total_kb` (int, KB, Android) — JVM heap currently allocated or committed. Included on every Android RESOURCE snapshot.
`_jvm_used_percent` (float, percent, Android) — JVM used as a percent of max. Included on every Android RESOURCE snapshot.
`_is_memory_low` (bool) — Whether the configured low-memory threshold is currently met. Present only when low-memory detection is configured.
`_native_used_kb` (int, KB, Android) — Native heap allocated. Included on every Android RESOURCE snapshot.
`_native_total_kb` (int, KB, Android) — Native heap total size. Included on every Android RESOURCE snapshot.
`_memory_class` (int, MB, Android) — Per-app memory class reported by Android. Included on every Android RESOURCE snapshot.
`_app_used_kb` (int, KB, iOS) — App physical memory footprint. Included on every Apple RESOURCE snapshot.
`_app_limit_kb` (int, KB, iOS) — Estimated app memory limit before termination. Included on every Apple RESOURCE snapshot.
`_app_used_percent` (float, percent, iOS) — App used memory as a percent of the estimated limit. Included on Apple snapshots when the memory limit estimate is valid.
`_device_kb` (int, KB, iOS) — Total device RAM. Included on every Apple RESOURCE snapshot.
`_battery_val` (float) — Battery level as a float. Included on every RESOURCE snapshot. May be -1.0 on Apple simulator.
`_battery_level` (int, percent, Android) — Battery percentage. Included on every Android RESOURCE snapshot.
`_battery_level` (int, percent, iOS) — Battery percentage when the battery level is known. Omitted on Apple simulator and other unknown battery states.
`_state` (string) — Battery charging state. Included on every RESOURCE snapshot.
`_battery_level_change_per_min` (float) — Battery percentage-point change per minute. Positive means draining, negative means charging. Present only after the rolling 1-minute battery window is populated.
`_low_power_enabled` (bool) — Low-power mode state. Included on every RESOURCE snapshot.
`_cache_dir_size_bytes` (int, bytes) — Cache directory size. Sampled at most once every 24 hours.
`_files_dir_size_bytes` (int, bytes, Android) — App files directory size. Sampled at most once every 24 hours.
`_external_cache_dir_size_bytes` (int, bytes, Android) — External cache directory size, when available. Sampled at most once every 24 hours.
`_external_files_dir_size_bytes` (int, bytes, Android) — External files directory size, when available. Sampled at most once every 24 hours.
`_documents_dir_size_bytes` (int, bytes, iOS) — Documents directory size. Sampled at most once every 24 hours.
`_tmp_dir_size_bytes` (int, bytes, iOS) — Temporary directory size. Sampled at most once every 24 hours.
`_request_bytes_per_min_count` (int, bytes/min) — Total outbound bytes over the preceding minute of tracked HTTP traffic. Present once the rolling 1-minute tracker has enough history.
`_request_body_bytes_per_min_count` (int, bytes/min) — Outbound request-body bytes over the preceding minute of tracked HTTP traffic. Present once the rolling 1-minute tracker has enough history.
`_request_headers_bytes_per_min_count` (int, bytes/min) — Outbound request-header bytes over the preceding minute of tracked HTTP traffic. Present once the rolling 1-minute tracker has enough history.
`_response_bytes_per_min_count` (int, bytes/min) — Total inbound bytes over the preceding minute of tracked HTTP traffic. Present once the rolling 1-minute tracker has enough history.
`_response_body_bytes_per_min_count` (int, bytes/min) — Inbound response-body bytes over the preceding minute of tracked HTTP traffic. Present once the rolling 1-minute tracker has enough history.
`_response_headers_bytes_per_min_count` (int, bytes/min) — Inbound response-header bytes over the preceding minute of tracked HTTP traffic. Present once the rolling 1-minute tracker has enough history. |
| SCREEN_VIEW | A screen or view is displayed. | `_screen_name` (string) — Name of the screen or view. |
| SDK_CONFIGURATION | SDK configuration is applied during SDK startup. | |
| SESSION_REPLAY | A Session Replay frame is captured. | |
| SPAN_END | A custom span ends. | `_span_id` (string) — Span identifier.
`_span_name` (string) — Span name.
`_span_parent_id` (string) — Parent span identifier.
`_duration_ms` (int, ms) — Span duration.
`_result` (string) — Span result. |
| SPAN_START | A custom span starts. | `_span_id` (string) — Span identifier.
`_span_name` (string) — Span name.
`_span_parent_id` (string) — Parent span identifier. |
| THERMAL_STATE_CHANGE | Device thermal state changes. | `_thermal_state` (string) — Thermal state of the device. |
| TIMEZONE_CHANGE | Device timezone changes. | `_time_zone` (string) — New timezone identifier. |
# OotbMatch.AndroidOotbConditionType
**Source definition:** [`src/bitdrift/public/unary/workflows/v1/workflow.proto#L1031-L1144`]()
Android-specific OOTB condition types. Includes all generic conditions plus Android-exclusive
events. Shared values carry the same well-known fields documented on GenericOotbConditionType.
No fields
# OotbMatch.AndroidOotbConditionType.AndroidOotbConditionType Enum
**Source definition:** [`src/bitdrift/public/unary/workflows/v1/workflow.proto#L1032-L1143`]()
| Name | Description | Fields |
|---|---|---|
| UNKNOWN | | |
| APP_ANDROID_BUILT_IN_ANR | The SDK's built-in fatal issue handler captures an Android app hang. | |
| APP_ANDROID_BUILT_IN_NATIVE_CRASH | The SDK's built-in fatal issue handler captures an Android native crash. | |
| APP_BACKGROUND | | |
| APP_BUILT_IN_JS_FATAL_ERROR | | |
| APP_BUILT_IN_JS_NON_FATAL_ERROR | | |
| APP_CLOSE | | |
| APP_CRASH | Android app crash. Carries crash details when available. Depending on the source, fields may describe a JVM exception or an OS-reported fatal exit. | `_app_exit_source` (string) — "UncaughtExceptionHandler" or "ApplicationExitInfo".
`_app_exit_info` (string) — Exception class name (UncaughtExceptionHandler only).
`_app_exit_details` (string) — Exception message (UncaughtExceptionHandler only).
`_app_exit_thread` (string) — Thread name (UncaughtExceptionHandler only).
`_app_exit_description` (string) — Exit description (ApplicationExitInfo only).
`_app_exit_process_name` (string) — Process name (ApplicationExitInfo only).
`_app_exit_importance` (string) — Process importance (ApplicationExitInfo only).
`_app_exit_status` (int) — Exit status code (ApplicationExitInfo only).
`_app_exit_pss` (int, KB) — Proportional set size at exit (ApplicationExitInfo only).
`_app_exit_rss` (int, KB) — Resident set size at exit (ApplicationExitInfo only). |
| APP_EXIT | Deprecated Android-only alias of APP_TERMINATION. Retained for legacy compatibility; prefer APP_TERMINATION for new workflows. | |
| APP_FOREGROUND | | |
| APP_LAUNCH | | |
| APP_LAUNCH_TTI | | |
| APP_OPEN | | |
| APP_TERMINATION | | |
| APP_UPDATE | | |
| BATTERY_STATE_CHANGE | | |
| DROPPED_FRAME | A rendering issue is detected for a UI frame. `_frame_issue_type` distinguishes slow, frozen, and ANR-classified frames. | `_frame_issue_type` (string) — Slow, Frozen, or ANR.
`_screen_name` (string) — Active screen name, if set.
`_duration_ms` (int, ms) — Frame duration. |
| GQL_REQUEST | | |
| GQL_RESPONSE | | |
| LOW_POWER_MODE | | |
| MEMORY_PRESSURE | | |
| NETWORK_REQUEST | | |
| NETWORK_RESPONSE | | |
| ORIENTATION_CHANGE | | |
| RESOURCE | | |
| SCREEN_VIEW | | |
| SDK_CONFIGURATION | | |
| SESSION_REPLAY | | |
| SPAN_END | | |
| SPAN_START | | |
| THERMAL_STATE_CHANGE | | |
| TIMEZONE_CHANGE | | |
# OotbMatch.AppleOotbConditionType
**Source definition:** [`src/bitdrift/public/unary/workflows/v1/workflow.proto#L1148-L1202`]()
Apple-specific OOTB condition types. Includes all generic conditions plus Apple-exclusive
events. Shared values carry the same well-known fields documented on GenericOotbConditionType.
No fields
# OotbMatch.AppleOotbConditionType.AppleOotbConditionType Enum
**Source definition:** [`src/bitdrift/public/unary/workflows/v1/workflow.proto#L1149-L1201`]()
| Name | Description | Fields |
|---|---|---|
| UNKNOWN | | |
| ANR | iOS app hang detected when the app stops responding for longer than the configured threshold. | `_duration_ms` (int, ms) — ANR duration.
`_threshold_duration_ms` (int, ms) — Configured ANR threshold.
`_span_id` (string) — Span identifier for the ANR. |
| APP_BACKGROUND | | |
| APP_BUILT_IN_JS_FATAL_ERROR | | |
| APP_BUILT_IN_JS_NON_FATAL_ERROR | | |
| APP_CLOSE | | |
| APP_FOREGROUND | | |
| APP_IOS_BUILT_IN_ANR | The SDK's built-in fatal issue handler captures an iOS app hang. | |
| APP_IOS_BUILT_IN_CRASH | The SDK's built-in fatal issue handler captures an iOS crash. | |
| APP_LAUNCH | | |
| APP_LAUNCH_TTI | | |
| APP_OPEN | | |
| APP_TERMINATION | | |
| APP_UPDATE | | |
| BATTERY_STATE_CHANGE | | |
| GQL_REQUEST | | |
| GQL_RESPONSE | | |
| LOW_POWER_MODE | | |
| MEMORY_PRESSURE | | |
| NETWORK_REQUEST | | |
| NETWORK_RESPONSE | | |
| ORIENTATION_CHANGE | | |
| RESOURCE | | |
| SCREEN_VIEW | | |
| SDK_CONFIGURATION | | |
| SESSION_REPLAY | | |
| SPAN_END | | |
| SPAN_START | | |
| THERMAL_STATE_CHANGE | | |
| TIMEZONE_CHANGE | | |