Skip to content

Latest commit

 

History

History
63 lines (32 loc) · 2.96 KB

File metadata and controls

63 lines (32 loc) · 2.96 KB

Configuring the 01-app-errors playbooks

The app errors module runs the mobile application errors model. It takes the mobile_events_staged table - produced by the Base module - as an input. The modules' staged output, mobile_app_errors_staged, is used as an input to the sessions module. The app errors module is optional, however if disabled an empty staged output table will still be created so as to allow the sessions module to run.

01-app-errors-main.yml.tmpl runs the main mobile model logic. 99-app-errors-complete.yml.tmpl runs the cleanup steps afterwards. XX-destroy-app-errors.yml.tmpl destroys all tables and manifests, for a complete rebuild.

Configuration quick reference

01-app-errors-main

:input_schema: name of atomic schema

:scratch_schema: name of scratch schema

:output_schema: name of derived schema

:enabled: boolean - Toggles the module on/off.

:entropy: string to append to all tables, to test without affecting prod tables (eg. _test produces tables like mobile_app_errors_test). Must match entropy value used for all other modules in a given run.

:stage_next: update staging tables - set to true if running the next module. If true, make sure that the next module includes a 'complete' step.

:upsert_lookback_days: default 30. Period of time (in days) to look back over the production table in order to find rows to delete when upserting data. Where performance is not a concern, should be set to as long a value as possible.

:skip_derived: default false. Set to true to skip insert to production app errors table.

Note: upsert_lookback_days can produce duplicates if set to too short a window.

99-app-errors-complete

:scratch_schema: name of scratch schema

:output_schema: name of derived schema

:entropy: string to append to all tables, to test without affecting prod tables. Must match entropy value used for all other modules in a given run.

:cleanup_mode: options: debug - only keeps main tables. trace - keeps all tables. all - cleans up everything.

:ends_run: set to true if there are no subsequent modules in the run, false otherwise.

XX-destroy-app-errors

:scratch_schema: name of scratch schema

:output_schema: name of derived schema

:entropy: string to append to all tables, to test without affecting prod tables. Must match entropy value used for all other modules in a given run.

:cleanup_mode: should be set to "all" for a destroy.

:ends_run: should be set to true for a destroy.

Order of execution

Custom steps should run before 99-app-errors-complete.yml.tmpl, but after 01-app-errors-main.yml.tmpl, as follows:

1: 01-app-errors-main.yml.tmpl

2: AA-my-custom-app-errors-level-module.yml.tmpl

3: 99-app-errors-complete.yml.tmpl

Custom modules should produce tables which join to the app errors table rather than altering it where possible.