# Install Dynatrace provider

## Install the Telemetry Provider <a href="#install-the-telemetry-provider" id="install-the-telemetry-provider"></a>

Skip this part if the Telemetry Provider is already installed.

To install the Dynatrace provider, create a YAML file (called `provider.yml` in this example) with the definition of the provider:

```yaml
# Dynatrace Telemetry Provider
name: Dynatrace
description: Telemetry Provider that enables to import metrics from Dynatrace installations
dockerImage: 485790562880.dkr.ecr.us-east-2.amazonaws.com/akamas/telemetry-providers/dynatrace-provider:3.4.3
```

Then you can install the provider using the Akamas CLI:

```bash
akamas install telemetry-provider provider.yml
```

## Offline Installation

An offline installation is designed for air-gapped or isolated environments where the Kubernetes cluster cannot directly access public repositories to download Docker images. In such scenarios, all necessary images—including telemetry providers—must be pre-downloaded, re-tagged, and pushed to a private registry that the cluster can access.

> **Note:** The following steps must be executed from a terminal that has internet access and connectivity to your private registry. This is required to pull the image from the public repository and then push it to your private registry. Once the images are available in your private registry, your offline environment can use them.

**Dynatrace Telemetry Provider Offline Procedure**

1. **Download and Transfer the Image to Your Private Registry:**

   Use Docker to pull the image from the public repository, re-tag it, and push it to your private registry. For example, if your private registry is `myprivateregistry.com`, execute:

   ```yaml
   # Pull the image from the public repository
   docker pull 485790562880.dkr.ecr.us-east-2.amazonaws.com/akamas/telemetry-providers/dynatrace-provider:3.4.3

   # Re-tag the image for your private registry
   docker tag 485790562880.dkr.ecr.us-east-2.amazonaws.com/akamas/telemetry-providers/dynatrace-provider:3.4.3 myprivateregistry.com/akamas/telemetry-providers/dynatrace-provider:3.4.3

   # Push the image to your private registry
   docker push myprivateregistry.com/akamas/telemetry-providers/dynatrace-provider:3.4.3
   ```
2. **Create the Updated YAML File:**

   Create a YAML file (e.g., `provider.yml`) with the provider specification, updating the `dockerImage` reference to point to your private registry:

   ```yaml
   # Dynatrace Telemetry Provider
   name: Dynatrace
   description: Telemetry Provider that enables to import metrics from Dynatrace installations
   dockerImage: myprivateregistry.com/akamas/telemetry-providers/dynatrace-provider:3.4.3
   ```
3. **Install the Provider Using the Akamas CLI:**

   With the updated YAML file, run the following command to install the provider:

   ```bash
   akamas install telemetry-provider provider.yml
   ```

   This command instructs the Akamas CLI to retrieve the image from your private registry, ensuring that the installation succeeds even in an offline environment.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.akamas.io/akamas-docs/integrating/integrating-telemetry-providers/dynatrace-provider/install-dynatrace-provider.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.