> ## Documentation Index
> Fetch the complete documentation index at: https://docs.resolve.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Scalyr

The Scalyr integration can be configured via Resolve's UI or on the Resolve Satellite

## Prerequisites

1. You will need a Scalyr API key to integrate with ResolveAI. Review the official documentation:  [https://app.scalyr.com/help/api-keys](https://app.scalyr.com/help/api-keys)

<Info>
  Ensure that at least the following role(s) are granted to the API token: **Log Read Access**
</Info>

## Option 1: Setup the Scalyr integration in ResolveAI

<Steps>
  <Step title="Login to ResolveAI">
    Login to [https://app0.resolve.ai](https://app0.resolve.ai). In the sidebar, select "Integrations"
  </Step>

  <Step title="Select Scalyr">
    Select "**Scalyr**" from the list. Click "Add Connection" at the top right.
  </Step>

  <Step title="Give the integration a name">
    Give the integration a name, e.g.: Scalyr-Main
  </Step>

  <Step title="Enter the environments">
    Enter the environments as specified in the Resolve Satellite installation that the integeration will map to.

    Each environment should be entered in a separate row.
  </Step>

  <Step title="Add your Scalyr API key">
    Add your Scalyr **API key**.
  </Step>

  <Step title="Enable sensitive data redaction (Optional)">
    **Enable** [**sensitive data redaction**](/sensitive-data-redaction) **(Optional)**

    <img src="https://mintcdn.com/resolveai-0e94a547/GuuijYwp3RfE7Xrj/images/external/b8921f843b4a.png?fit=max&auto=format&n=GuuijYwp3RfE7Xrj&q=85&s=1216b5a10eb82398694d5bb4a2004af7" alt="" width="1034" height="270" data-path="images/external/b8921f843b4a.png" />
  </Step>

  <Step title="Save">
    Click "**Save**".
  </Step>
</Steps>

## Option 2: Setup the Scalyr integration through the Resolve Satellite

Below is an example of how to setup the Scalyr integration in the satellite using the k8s secret (potentially backed by an AWS secret manager or another mechanism) for authenticating. The secret format in this example is for a Scalyr API key.

<Steps>
  <Step title="Create a Kubernetes secret">
    Create a Kubernetes secret of the following form. Note that the structure of the secret is important.

    ```yaml secret creation theme={null}
    apiVersion: v1
    kind: Secret
    type: Opaque
    metadata:
      name:  scalyr-resolve-token
    stringData:
      token: "<your API key>"
    ```

    <Warning>
      **Security Best Practice:** Never store credentials in plaintext in configuration files or source control.
      Always use Kubernetes secrets and encrypt etcd or use enterprise secret management systems.
      See [Secret Management](/secret-management) for detailed guidance.
    </Warning>

    To apply the secret run

    ```shell apply secret theme={null}
    kubectl apply -f scalyr-resolve-token.yml
    ```
  </Step>

  <Step title="Configure your Scalyr API key in the Resolve Satellite">
    Update your helm values override file with the following information (e.g.: *resolve-values.yaml*)

    ```yaml resolve-values.yaml theme={null}
    integrations:
      scalyrOnPrem:
        type: "scalyr"
        create: true
        secretName: "scalyr-resolve-token"
    ```
  </Step>

  <Step title="Enable sensitive data redaction (Optional)">
    **Enable** [**sensitive data redaction**](/sensitive-data-redaction) **(Optional)**

    Append the `redactionConfig` configuration in the helm values file (e.g.: *resolve-values.yaml*)

    ```yaml resolve-values.yaml theme={null}
    integrations:
      scalyrOnPrem:
        type: "scalyr"
        create: true
        secretName: "scalyr-resolve-token"
        connection:
          redactionConfig:
            enabled: true
    ```
  </Step>

  <Step title="Apply the satellite values">
    Install the satellite and apply the values from the yaml file that you have just updated. e.g.: *resolve-values.yaml.* To find the latest version, visit ResolveAI's docker hub repository for the [helm chart](https://hub.docker.com/r/resolveaihq/satellite-chart/tags) and [satellite image](https://hub.docker.com/r/resolveaihq/satellite/tags).

    ```shell apply config to satellite and redeploy theme={null}
    helm upgrade --install oci://registry-1.docker.io/resolveaihq/satellite-chart --version <LatestChart> --values resolve-values.yaml --set image.tag=<LatestImage>
    ```

    Once your satellite is deployed, we will automatically create an integration instance for you.
  </Step>

  <Step title="Verify your integration status in ResolveAI">
    Login to [https://app0.resolve.ai/](https://app0.resolve.ai/). Go to the integrations page and and select “Scalyr”

    You should see an automatically created integration based on the provided configuration.
  </Step>
</Steps>