Metrics

StatsD Metrics in Eliot

Eliot uses StatsD with DogStatsD extensions.

Table of metrics:

Key	Type
eliot.pageview	incr
eliot.symbolicate.api	timing
eliot.symbolicate.request_error	incr
eliot.downloader.download	histogram
eliot.symbolicate.parse_sym_file.error	incr
eliot.symbolicate.parse_sym_file.parse	timing
eliot.symbolicate.jobs_count	histogram
eliot.symbolicate.stacks_count	histogram
eliot.symbolicate.frames_count	histogram
eliot.diskcache.get	histogram
eliot.diskcache.set	histogram
eliot.diskcache.evict	incr
eliot.diskcache.usage	gauge
eliot.sentry_scrub_error	incr

Metrics details:

eliot.pageview

Type: incr

Counter for page views.

Tags:

• path: the url path

• method: the request method

eliot.symbolicate.api

Type: timing

Timer for long a symbolication API request takes to handle.

Tags:

• version: the symbolication api version

  • v4: the v4 API

  • v5: the v5 API

eliot.symbolicate.request_error

Type: incr

Counter for errors in incoming symbolication requests.

Tags:

• reason: the error reason

  • bad_json: the payload is not valid JSON

  • invalid_modules: the payload has invalid modules

  • invalid_stacks: the payload has invalid stacks

  • too_many_jobs: (v5) the payload has too many jobs in it

eliot.downloader.download

Type: histogram

Timer for how long it takes to download SYM files.

Tags:

• response: the HTTP response we got back

  • success: HTTP 200

  • fail: HTTP 404, 500, etc

eliot.symbolicate.parse_sym_file.error

Type: incr

Counter for when a sym file fails to parse.

Tags:

• reason: the reason it failed to parse

  • bad_debug_id: debug_id is not valid

  • sym_debug_id_lookup_error: when the debug_id isn’t in the sym file

  • sym_tmp_file_error: error creating tmp file to save the sym file to disk

eliot.symbolicate.parse_sym_file.parse

Type: timing

Timer for how long it takes to parse sym files with Symbolic.

eliot.symbolicate.jobs_count

Type: histogram

Histogram for how many jobs were in the symbolication request.

Tags:

• version: the symbolication api version

  • v4: the v4 API

  • v5: the v5 API

eliot.symbolicate.stacks_count

Type: histogram

Histogram for how many stacks per job were in the symbolication request.

Tags:

• version: the symbolication api version

  • v4: the v4 API

  • v5: the v5 API

eliot.symbolicate.frames_count

Type: histogram

Histogram for how many frames per stack were in the symbolication request.

eliot.diskcache.get

Type: histogram

Timer for how long it takes to get symcache files from the disk cache.

Tags:

• result: the cache result

  • hit: the file was in cache

  • error: the file was in cache, but there was an error reading it

  • miss: the file was not in cache

eliot.diskcache.set

Type: histogram

Timer for how long it takes to save a symcache file to the disk cache.

Tags:

• result: the cache result

  • success: the file was saved successfully

  • fail: the file was not saved successfully

eliot.diskcache.evict

Type: incr

Counter for disk cache evictions.

eliot.diskcache.usage

Type: gauge

Gauge for how much of the cache is in use.”

eliot.sentry_scrub_error

Type: incr

Emitted when there are errors scrubbing Sentry events. Monitor these because it means we’re missing Sentry event data.