Skip to content

Conversation

@ivomurrell
Copy link
Contributor

Description

This package allows us to send metrics from Tool Kit invocations to a backend server, currently planned to be an instance of Vector running in AWS. We can use these metrics to get visibility for how people use Tool Kit, and where things may be going wrong. For now, I've only added one metric, which tracks what Tool Kit tasks are run and whether they completed successfully.

The telemetry package uses a child process to allow us to send the metrics asynchronously and in the background once the main Tool Kit process exits, meaning there is minimal impact on the time it takes for Tool Kit commands to run on developer machines.

Children of the metrics class can be created with arbitrary attributes overridden, and these classes are passed around between functions and stored as fields in Task and Hook classes, allowing important metadata, such as whether we're in CI or the name of the task currently running, to always be included in recorded events and scoped logically.

It doesn't make sense for this to be released yet as the backend server isn't ready but we can either put this in the dev branch if we manage to get that working or leave this unmerged for now.

Checklist:

  • My branch has been rebased onto the latest commit on main (don't merge main into your branch)
  • My commit messages are conventional commits, for example: feat(circleci): add support for nightly workflows, fix: set Heroku app name for staging apps too

This package allows us to send metrics from Tool Kit invocations to a
backend server, currently planned to be an instance of Vector running in
AWS. We can use these metrics to get visibility for how people use Tool
Kit, and where things may be going wrong. For now, I've only added one
metric, which tracks what Tool Kit tasks are run and whether they
completed successfully.

The telemetry package uses a child process to allow us to send the
metrics asynchronously and in the background once the main Tool Kit
process exits, meaning there is minimal impact on the time it takes for
Tool Kit commands to run on developer machines.

Children of the metrics class can be created with arbitrary attributes
overridden, and these classes are passed around between functions and
stored as fields in Task and Hook classes, allowing important metadata,
such as whether we're in CI or the name of the task currently running,
to always be included in recorded events and scoped logically.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants