Files
tracer-cloud--opensre/docs/coralogix.mdx
T
wehub-resource-sync 4b6817381b
CI (OpenClaw E2E) / openclaw test (push) Has been cancelled
CI / coverage-report (push) Has been cancelled
CI / test-kubernetes (push) Has been cancelled
CI / should-run-thorough (push) Has been cancelled
CI / test-thorough (cloudwatch-demo) (push) Has been cancelled
CI / test-thorough (flink-ecs) (push) Has been cancelled
CI / test-thorough (upstream-lambda) (push) Has been cancelled
CI / test-thorough (prefect-ecs-fargate) (push) Has been cancelled
Release / build-binaries (zip, opensre.exe, onefile, windows-latest, windows-x64) (push) Has been cancelled
Benchmark image — build + push to ECR (any adapter) / build + push (push) Has been cancelled
CI / quality (ubuntu-latest) (push) Has been cancelled
CI / test (tools-runtime) (push) Has been cancelled
CI / test (e2e-general) (push) Has been cancelled
CI / test (cli-runtime) (push) Has been cancelled
CI / test (e2e-provider-and-openclaw) (push) Has been cancelled
CI / test (integrations-and-misc) (push) Has been cancelled
Release / verify (push) Has been cancelled
Release / build-python-dist (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, macos-15-intel, darwin-x64) (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, macos-latest, darwin-arm64) (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, ubuntu-22.04, linux-x64) (push) Has been cancelled
Release / publish-release (push) Has been cancelled
Release / publish-main-release (push) Has been cancelled
Interactive Shell Live (PR + post-merge) / turn-checks (no-LLM) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
Interactive Shell Live (PR + post-merge) / turn-live shard ${{ matrix.shard_index }} (push) Has been cancelled
Release / prepare (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, ubuntu-22.04-arm, linux-arm64) (push) Has been cancelled
Synthetic Deterministic Tests / Synthetic offline (deterministic) (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 13:10:45 +08:00

105 lines
2.6 KiB
Plaintext

---
title: "Coralogix"
description: "Connect Coralogix so OpenSRE can query logs during investigations"
---
OpenSRE queries Coralogix using DataPrime to surface relevant logs during alert investigations — correlating log patterns with incidents and identifying root causes.
## Prerequisites
- Coralogix account with DataPrime query access
- Logs API key
## Setup
### Option 1: Interactive CLI
```bash
opensre integrations setup
```
Select **Coralogix** when prompted and provide your API key and endpoint.
### Option 2: Environment variables
Add to your `.env`:
```bash
CORALOGIX_API_KEY=your-logs-api-key
CORALOGIX_API_URL=https://api.coralogix.com # optional
CORALOGIX_APPLICATION_NAME=my-app # optional filter
CORALOGIX_SUBSYSTEM_NAME=my-service # optional filter
```
| Variable | Default | Description |
| --- | --- | --- |
| `CORALOGIX_API_KEY` | — | **Required.** Coralogix Logs Query API key |
| `CORALOGIX_API_URL` | `https://api.coralogix.com` | Endpoint for your Coralogix cluster |
| `CORALOGIX_APPLICATION_NAME` | — | Filter queries to this application |
| `CORALOGIX_SUBSYSTEM_NAME` | — | Filter queries to this subsystem |
### Option 3: Persistent store
```json
{
"version": 1,
"integrations": [
{
"id": "coralogix-prod",
"service": "coralogix",
"status": "active",
"credentials": {
"api_key": "your-logs-api-key",
"base_url": "https://api.coralogix.com",
"application_name": "my-app",
"subsystem_name": "my-service"
}
}
]
}
```
## Cluster endpoints
| Region | API URL |
| --- | --- |
| US1 | `https://api.coralogix.com` |
| EU1 | `https://api.eu1.coralogix.com` |
| EU2 | `https://api.eu2.coralogix.com` |
| AP1 | `https://api.ap1.coralogix.com` |
| AP2 | `https://api.ap2.coralogix.com` |
## Creating an API key
1. In Coralogix, go to **Data Flow** → **API Keys**
2. Click **+ New API Key**
3. Select **Logs Query** as the key type
4. Copy the key
## Verify
```bash
opensre integrations verify coralogix
```
Expected output:
```
Service: coralogix
Status: passed
Detail: Connected to https://api.coralogix.com (application my-app); DataPrime returned 0 row(s)
```
## Troubleshooting
| Symptom | Fix |
| --- | --- |
| **401 Unauthorized** | Check the API key and ensure it's a Logs Query key |
| **Connection timeout** | Verify `CORALOGIX_API_URL` matches your cluster region |
| **No results** | Confirm `CORALOGIX_APPLICATION_NAME` and `CORALOGIX_SUBSYSTEM_NAME` match your data |
## Security best practices
- Use a **read-only** Logs Query key — avoid admin or send-data keys.
- Store the API key in `.env`, not in source code.