A Terraform module which tracks telemetry information back to Snowplow Analytics Ltd so that we can better understand how our community is leveraging the OSS Terraform modules we make available. It is also responsible for generating the tracking tags and user-data scripts which are added to upstream application specific modules.

This module uses a combination of the Snowplow Terraform provider and Snowplow Tracking CLI to achieve these telemetry goals. Within the module itself we will track the state of the module itself and what state it is in.

For use outside of this module we produce a user-data script which tracks the state of the VM an application is running on with a startup, shutdown and heartbeat event (60 minute interval).

module "telemetry" {
  source = "snowplow-devops/telemetry/snowplow"

  count = var.telemetry_enabled ? 1 : 0

  user_provided_id = var.user_provided_id
  cloud            = "AWS"
  region           = data.aws_region.current.name
  app_name         = var.app_name
  app_version      = var.app_version
  module_name      = var.module_name
  module_version   = var.module_version
}

Note: See the templates for the exact user-data that is executed.

No modules.

The Terraform Snowplow Telemetry project is Copyright 2021-2023 Snowplow Analytics Ltd.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this software except in compliance with the License.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.