Github Exporter

The github_exporter_config block configures the github_exporter integration, which is an embedded version of github_exporter. This allows for the collection of metrics from the github api.

We strongly recommend that you configure a separate authentication token for the Agent, and give it only the strictly mandatory security privileges necessary for monitoring your repositories, as per the official documentation. We also recommend that you use api_token_file parameter, to avoid setting the authentication token directly on the Agent config file.

Full reference of options:

  1.   # Enables the github_exporter integration, allowing the Agent to automatically
  2.   # collect metrics for the specified github objects.
  3.   [enabled: <boolean> | default = false]
  5.   # Sets an explicit value for the instance label when the integration is
  6.   # self-scraped. Overrides inferred values.
  7.   #
  8.   # The default value for this integration is inferred from the hostname portion
  9.   # of api_url.
  10.   [instance: <string>]
  12.   # Automatically collect metrics from this integration. If disabled,
  13.   # the github_exporter integration will be run but not scraped and thus not
  14.   # remote-written. Metrics for the integration will be exposed at
  15.   # /integrations/github_exporter/metrics and can be scraped by an external
  16.   # process.
  17.   [scrape_integration: <boolean> | default = <integrations_config.scrape_integrations>]
  19.   # How often should the metrics be collected? Defaults to
  20.   # prometheus.global.scrape_interval.
  21.   [scrape_interval: <duration> | default = <global_config.scrape_interval>]
  23.   # The timeout before considering the scrape a failure. Defaults to
  24.   # prometheus.global.scrape_timeout.
  25.   [scrape_timeout: <duration> | default = <global_config.scrape_timeout>]
  27.   # Allows for relabeling labels on the target.
  28.   relabel_configs:
  29.     [- <relabel_config> ... ]
  31.   # Relabel metrics coming from the integration, allowing to drop series
  32.   # from the integration that you don't care about.
  33.   metric_relabel_configs:
  34.     [ - <relabel_config> ... ]
  36.   # How frequent to truncate the WAL for this integration.
  37.   [wal_truncate_frequency: <duration> | default = "60m"]
  39.   #
  40.   # Exporter-specific configuration options
  41.   #
  43.   # The full URI of the github API.
  44.   [api_url: <string> | default = "https://api.github.com"]
  46.   # A list of github repositories for which to collect metrics.
  47.   repositories:
  48.     [ - <string> ]
  50.   # A list of github organizations for which to collect metrics.
  51.   organizations:
  52.     [ - <string> ]
  54.   # A list of github users for which to collect metrics.
  55.   users:
  56.     [ - <string> ]
  58.   # A github authentication token that allows the API to be queried more often.
  59.   # Optional, but recommended.
  60.   [api_token: <string>]
  62.   # A path to a file containing a github authentication token that allows the
  63.   # API to be queried more often. If supplied, this supercedes `api_token`
  64.   # Optional, but recommended.
  65.   [api_token_file: <string>]