Grafana Alloy data collection
Grafana Cloud

Grafana Alloy data collection

Grafana Alloy includes a system that optionally and anonymously reports non-sensitive, non-personally identifiable information about Alloy to a remote statistics server. Alloy maintainers use this anonymous information to learn how the open source community runs Alloy. This data helps the Alloy team prioritize features and improve documentation.

The anonymous usage statistics reporting is enabled by default. You can opt out by setting the CLI flag --disable-reporting to true.

The statistics server

When usage statistics reporting is enabled, a server that Grafana Labs runs collects the information. The statistics are collected at https://stats.grafana.org.

Which information is collected

When usage statistics reporting is enabled, Alloy collects the following information:

  • A randomly generated, anonymous, unique ID (UUID).
  • The timestamp when the UUID was first generated.
  • The timestamp when the report was created (by default, every four hours).
  • The version of Alloy.
  • The operating system where Alloy is running.
  • The system architecture where Alloy is running.
  • A list of enabled components.
  • The deployment method for Alloy, such as Docker, Helm, or a Linux package.

Note

Alloy maintainers commit to keeping the list of tracked information updated over time. Any changes are reported in the CHANGELOG.

Disable the anonymous usage statistics reporting

If possible, we ask you to keep the usage reporting feature enabled to help us understand how the open source community runs Alloy. If you want to opt out of anonymous usage statistics reporting, set the CLI flag --disable-reporting to true.

Example: Opt-out of data collection with Ansible

yaml
- name: Install Alloy
  hosts: all
  become: true
  tasks:
    - name: Install Alloy
      ansible.builtin.include_role:
        name: grafana.grafana.alloy
      vars:
        alloy_env_file_vars:
          CUSTOM_ARGS: "--disable-reporting"