Files
cloudkitty/doc/source/admin/configuration/fetcher.rst
Olivier Chaze 3c7f573cb3 Adding two options in fetcher_keystone
This patch adds two options in fetcher_keystone to filter which tenants
should be rated:

ignore_disabled_tenants (Default=False)
ignore_rating_role (Default=False)

In our case we currently have 2k projects (growing) and we want to rate
all active projects, so checking the role rating is useless and consumes
resources for nothing. Besides, cloudkitty rates projects regardless if
there are enabled or disabled which is also useless and consumes
resources in our case.

Change-Id: I6479d76c367dc4217bce4de9c3db41c4612f0397
2021-11-29 22:27:52 +01:00

3.3 KiB

Fetcher configuration

Backend option

backend is a common option specified in the [fetcher] section of the configuration file. It defaults to keystone and specifies the driver to be used for fetching the list of scopes to rate.

Fetcher-specific options

Fetcher-specific options must be specified in the fetcher_{fetcher_name} section of cloudkitty.conf.

Gnocchi

Section fetcher_gnocchi.

  • scope_attribute: Defaults to project_id. Attribute from which scope_ids should be collected.
  • resource_types: Defaults to [generic]. List of gnocchi resource types. All if left blank.
  • gnocchi_auth_type: Defaults to keystone. Defines what authentication method should be used by the gnocchi fetcher. Must be one of basic (for gnocchi basic authentication) or keystone (for classic keystone authentication). If keystone is chosen, credentials can be specified in a section pointed at by the auth_section parameter.
  • gnocchi_user: For gnocchi basic authentication only. The gnocchi user.
  • gnocchi_endpoint: For gnocchi basic authentication only. The gnocchi endpoint.
  • interface: Defaults to internalURL. For keystone authentication only. The interface to use for keystone URL discovery.
  • region_name: Defaults to RegionOne. For keystone authentication only. Region name.

Keystone

Section fetcher_keystone.

  • keystone_version: Defaults to 3. Keystone version to use.
  • auth_section: If the auth_section option is defined then all the options declared in the target section will be used in order to fetch scopes through Keystone service.

If auth_section option is not defined then you can configure Keystone fetcher using regular Keystone authentication options as found here: configuration.

  • ignore_rating_role: if set to true, the Keystone fetcher will not check if a project has the rating role; thus, CloudKitty will execute rating for every project it finds. Defaults to false.
  • ignore_disabled_tenants: if set to true, Cloudkitty will not rate projects that are disabled in Keystone. Defaults to false.

Monasca

Section fetcher_monasca.

  • dimension_name: Monasca dimension from which scope_ids is collected.
  • monasca_tenant_id: If specified, monasca client will use this ID instead of the default one.
  • monasca_service_name: Name of the Monasca service (defaults to monasca).
  • interface: Endpoint URL type (defaults to internal).

Prometheus

Section fetcher_prometheus.

  • metric: Metric from which scope_ids should be requested.
  • scope_attribute: Defaults to project_id. Attribute from which scope_ids should be requested.
  • filters: Optional key-value dictionary to use additional metadata to filter out some of the Prometheus service response.
  • prometheus_url: Prometheus HTTP API URL.
  • prometheus_user: For HTTP basic authentication. The username.
  • prometheus_password: For HTTP basic authentication. The password.
  • cafile: Option to allow custom certificate authority file.
  • insecure: Option to explicitly allow untrusted HTTPS connections.

Source

Section fetcher_source.

  • sources: Explicit list of scope_ids.