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

# Coralogix

> Learn how to integrate Vantage with Coralogix.

Vantage connects to Coralogix organizations through [gRPC API](https://grpc.io/) calls. After Vantage is authorized to access your Coralogix organization, Vantage will ingest data using the Coralogix [Data Usage Service API](https://coralogix.com/docs/developer-portal/apis/data-management/data-usage-service-api/) endpoints. No access is granted to the Coralogix-connected applications. Vantage can see only usage data related to the connected services.

Vantage supports the Logs, Metrics, and Spans services, as well as the [application and subsystem names](https://coralogix.com/docs/user-guides/account-management/account-settings/application-and-subsystem-names/) for your account. The subsystem name typically refers to the environment (e.g., production, development, or staging). The application name typically refers to the name of the service or applications that send your logs, metrics, and traces. Both the subsystem and application names can be customized, so your values may be different.

## Connect Your Coralogix Account

### Prerequisites

* You must have a Vantage **Organization Owner** or **Integration Owner** role to add or remove this integration. See the [Role-Based Access Control](/rbac) documentation for details.
* You will need to be an [Organization Admin](https://coralogix.com/docs/user-guides/account-management/organization-management/organization-admins/) in Coralogix.
* [Create a free Vantage account](https://console.vantage.sh/signup), then follow the steps below to connect to Coralogix.

### Create the Connection

<Steps>
  <Step>
    Log in to the [Coralogix dashboard](https://dashboard.coralogix.com/).

    <Tip>
      If you experience issues logging in to your dashboard, your account may be using a different domain. Ensure you use the [correct domain](https://coralogix.com/docs/user-guides/account-management/account-settings/coralogix-domain/) to log in to your dashboard.
    </Tip>
  </Step>

  <Step>
    On the left, navigate to **Settings**. Under **Users and Teams**, select **API Keys**.
  </Step>

  <Step>
    Click **+ Add key** and create a new Team key. Team keys are recommended for production integrations.

    <Info>
      You can also use a Personal key; however, Coralogix recommends Team keys for production use. See the [Coralogix API keys documentation](https://coralogix.com/docs/user-guides/account-management/api-keys/api-keys/) for details on key types.
    </Info>
  </Step>

  <Step>
    Add a recognizable key name. From the **Role Presets** dropdown, select the **DataUsage** preset. This preset grants the `data-usage:Read` and `data-usage:Manage` permissions required for the Vantage integration.
  </Step>

  <Step>
    Click **Create**, then copy and save the generated key. If [API Key Security Settings](https://coralogix.com/docs/user-guides/account-management/api-keys/api-keys/#security) are enabled, you will have a one-time opportunity to view and copy the key.

    <Warning>
      If you are migrating from a legacy "Alerts, Rules and Tags" API key, you will need to create a new key with the **DataUsage** preset. Adding permissions to existing legacy keys may not work. See the [Coralogix migration guide](https://coralogix.com/docs/user-guides/account-management/api-keys/api-keys/#migrate-legacy-keys-to-custom-api-keys) for details.
    </Warning>
  </Step>

  <Step>
    Identify your Coralogix [domain](https://coralogix.com/docs/user-guides/account-management/account-settings/coralogix-domain/). You can find this from your Coralogix account URL. Copy the part of the domain after your team's name. For example, if your account URL is `https://test-team.cx498.coralogix.com/`, then copy only `cx498.coralogix.com`.
  </Step>

  <Step>
    Navigate to the [Integrations page](https://console.vantage.sh/settings/integrations) in Vantage.
  </Step>

  <Step>
    Select **Coralogix** and select the **Connect** tab.
  </Step>

  <Step>
    At the bottom of the page, click **Add API Key**.
  </Step>

  <Step>
    Enter your previously generated **API Key** and the **Domain** you copied.
  </Step>

  <Step>
    Enter a **Description** for this connection. The **Description** is your team name and is also available in your Coralogix domain URL (e.g., in `https://test-team.cx498.coralogix.com/`, use `test-team`).
  </Step>

  <Step>
    Click **Connect Account**.
  </Step>
</Steps>

After authorizing the connection, you will see the status of your integration change to **Importing** within the Vantage console. This status indicates that Vantage is actively importing your Coralogix cost data. See the [Integration Status](/vantage_account#integration-status) documentation for details on integration statuses.

<Info>
  Based on limits imposed by Coralogix, the integration includes 90 days of historical Coralogix usage and cost data. Once costs are processed, they will be available on your **All Resources** Cost Report.
</Info>

### Next Steps - Manage Workspace Access

Once the import is complete and the integration status changes to **Stable**, you can select which workspaces this integration is associated with. See the [Workspaces](/workspaces#manage-workspace-provider-integrations) documentation for information.

## Data Refresh

See the [provider data refresh documentation](/provider_data_refresh) for information on when data for each provider refreshes in Vantage.

## Custom Discounts and Rates

If you have custom rates or discounts negotiated with Coralogix, Vantage can implement these into your cost calculations. Please contact [Vantage Support](mailto:support@vantage.sh) to set up custom rates. When using custom rates, please double-check your calculations and stay on top of any adjustments made to future rates so we can continue to update them accordingly.

## Coralogix Reporting Dimensions

On Coralogix [Cost Reports](/cost_reports/), you can filter costs across several dimensions:

* Service (e.g., Logs, Metrics, Spans)
* Category (subsystem name)
* Subcategory (application name)
* Tag ([virtual tags](/tagging) created in Vantage for this provider)