# Telemetry Instance template

Telemetry instances are defined using a YAML manifest with the following structure:

{% code lineNumbers="true" %}

```yaml
provider: Provider Name
config:
  providerSpecificConfig1: "<value>"
  providerSpecificConfig2: 123
metrics:
- name: metric_name
  datasourceName: datsource_metric_name
  labels:
    - label1
    - label2
  staticLabels:
    staticLabel1: staticValue1
    staticLabel2: staticValue2
```

{% endcode %}

with the following properties for the global section

<table><thead><tr><th width="160">Name</th><th width="102">Type</th><th width="398">Description</th><th>Mandatory</th></tr></thead><tbody><tr><td><code>provider</code></td><td>string</td><td>The name of the Telemetry Provider</td><td>Yes</td></tr><tr><td><code>config</code></td><td>object</td><td>Provider-specific configuration in a key-value format (see specific provider documentation for details)</td><td>Yes</td></tr><tr><td><code>metrics</code></td><td>object</td><td>This section is used to specify the metrics to extract. This section is specific for each Telemetry Provider (see specific provider documentation for details)</td><td>No</td></tr></tbody></table>

and the metrics section

<table><thead><tr><th width="207">Name</th><th width="118">Type</th><th width="346">Description</th><th>Mandatory</th></tr></thead><tbody><tr><td><code>name</code></td><td>string</td><td><p>Name of the metric in Akamas.</p><p>This metric must exists in at least one of the referred by the System associated with the Telemetry Provider Instance</p></td><td>Yes</td></tr><tr><td><code>datasourceName</code></td><td>string</td><td>Name of the metric (or extraction query) in the data source. The value of this parameter is specific to the data source.</td><td>Yes</td></tr><tr><td><code>labels</code></td><td>List of strings</td><td>List of labels. For the specific usage of this parameter, see the documentation of the specific Telemetry Provider </td><td>No</td></tr><tr><td><code>staticLabels</code></td><td>List of key-value pair</td><td>List of Key-Value pairs that are interpreted as a pair of labels name and value. This "static labels" are copied directly in each sample of the specific metric and sent to the Metric Service</td><td>No</td></tr></tbody></table>
