# Causely

> Causely documentation for the causal AI engine that explains, predicts, and helps resolve software incidents.

Start with the Causely GenAI primer for grounding and terminology:
- [Causely GenAI Primer](https://docs.causely.ai/llms-primer.md): canonical framing, terminology, and interpretation guidance for Causely outputs.

For deep technical questions not answered by a specific page below, fetch the full documentation corpus:
- [Full LLM Corpus](https://docs.causely.ai/llms-full.txt): the complete Causely documentation in one file (~190k tokens). Prefer fetching a specific page from the table of contents below when possible; use this only when you need the entire corpus at once.

Recommended navigation:
- [Quick Setup](https://docs.causely.ai/getting-started/quick-setup.md): first-time install and onboarding.
- [Integrate Agents](https://docs.causely.ai/agent-integration.md): connect chat and coding agents to Causely.
- [API](https://docs.causely.ai/api.md): API workflows and integration details.
- [Reference](https://docs.causely.ai/reference.md): symptoms, root causes, and operational reference content.

## Table of Contents

- [Quick Setup Guide for Causely](https://docs.causely.ai/getting-started/quick-setup.md): Learn how to set up Causely quickly and efficiently. Follow our step-by-step guide to plan your deployment, install the Causely mediator, configure...
- [How Causely Works](https://docs.causely.ai/getting-started/how-causely-works.md): Understanding the core concepts and mechanisms behind Causely's causal reasoning engine.
- [Agent Integration](https://docs.causely.ai/agent-integration/agent-integration.md): Learn how to integrate Causely into agent workflows to move from querying telemetry to making reliable, system-aware decisions.
- [API Reference Guide](https://docs.causely.ai/api/api.md): Complete Causely GraphQL API documentation with authentication examples, Python SDK, curl commands, and code samples for monitoring and observabili...
- [SLO Targets and Burn Rates](https://docs.causely.ai/configuration/slo-configuration.md): Configure custom SLO targets and burn rate behavior using labels
- [Root Causes](https://docs.causely.ai/in-action/root-causes.md): See how the Root Cause view distills symptoms into actionable causes, how urgency and states work, and what details and remediation options are ava...
- [Troubleshooting Telemetry Sources](https://docs.causely.ai/telemetry-sources/troubleshooting.md): Common issues and solutions for telemetry source integrations in Causely
- [Learn](https://docs.causely.ai/reference/reference.md): Learn about entity types, root causes, terminology, and security
- [Custom Agents](https://docs.causely.ai/agent-integration/custom-agents.md): Build your own agents and workflows using Causely via MCP or API.
- [HolmesGPT](https://docs.causely.ai/agent-integration/holmes-gpt.md): Use Causely with HolmesGPT to enable reliable, system-aware incident investigation and automation.
- [Advanced Authentication](https://docs.causely.ai/agent-integration/mcp-server/advanced-auth.md): Configure client ID/secret machine credentials and the mcp-remote stdio fallback for the Causely MCP server.
- [Claude Code](https://docs.causely.ai/agent-integration/mcp-server/claude-code.md): Connect the Causely MCP server to Claude Code to run incident triage, service health checks, and reliability reports from the terminal.
- [Claude Desktop](https://docs.causely.ai/agent-integration/mcp-server/claude-desktop.md): Ask Causely questions in natural language from the Claude desktop app using the MCP server.
- [OpenAI Codex](https://docs.causely.ai/agent-integration/mcp-server/codex.md): Connect the Causely MCP server to OpenAI Codex for reliability workflows alongside your coding tasks.
- [Cursor](https://docs.causely.ai/agent-integration/mcp-server/cursor.md): Connect the Causely MCP server to Cursor to investigate incidents and check service health without leaving your editor.
- [MCP Server Integration](https://docs.causely.ai/agent-integration/mcp-server.md): Connect to "Ask Causely" directly from your IDE or CLI using the Model Context Protocol
- [Skills](https://docs.causely.ai/agent-integration/mcp-server/skills.md): Pre-built skill workflows that automatically route your observability questions to the right Causely MCP tools.
- [VS Code (GitHub Copilot)](https://docs.causely.ai/agent-integration/mcp-server/vscode-copilot.md): Connect the Causely MCP server to GitHub Copilot in VS Code to query root causes and service health from your editor.
- [API Authentication](https://docs.causely.ai/api/authentication.md): Learn how to authenticate with the Causely GraphQL API using Bearer tokens and API client credentials.
- [Gateway Token Management](https://docs.causely.ai/api/gateway-tokens.md): Learn how to create and manage Causely gateway tokens via the REST API for automated mediator deployment workflows.
- [Setting Up GraphQL Clients](https://docs.causely.ai/api/graphql-clients.md): Learn how to set up reusable GraphQL API clients for efficient integration with the Causely GraphQL API.
- [Query Defects and Root Causes](https://docs.causely.ai/api/queries/defects.md): Learn how to query high-severity active defects and root causes using the Causely GraphQL API.
- [Get User Scopes](https://docs.causely.ai/api/queries/getting-started.md): Learn how to query user scopes and access permissions using the Causely GraphQL API.
- [Hiding Root Causes](https://docs.causely.ai/api/queries/hiding-root-causes.md): Learn how to hide root causes for a time period using Entity Configs with the Causely GraphQL API.
- [Testing Notification Payloads](https://docs.causely.ai/api/queries/notifications.md): Learn how to send test notifications to Causely using the GraphQL API with representative payloads.
- [Setting SLOs on HTTP Paths and RPC Methods](https://docs.causely.ai/api/queries/setting-slos-on-paths-and-methods.md): Learn how to enable and manage SLOs for HTTP Paths or RPC Methods using Entity Configs with the Causely GraphQL API.
- [Alert Ingestion and Mapping](https://docs.causely.ai/configuration/alert-ingestion.md): Understand how Causely ingests external alerts, maps them to entities and symptoms, and feeds them into causal analysis.
- [Credentials Autodiscovery](https://docs.causely.ai/configuration/credentials-autodiscovery.md): Add new scraping targets without updating the Causely configuration
- [Custom Causes](https://docs.causely.ai/configuration/custom-causes.md): Define your own causes for alerts that Causely does not automatically recognize, so they participate in root cause analysis with your own descripti...
- [Configuration](https://docs.causely.ai/configuration/configuration.md): Causely configuration overview
- [Scopes](https://docs.causely.ai/configuration/scopes.md): Create scopes to tailor your experience and focus on the data that matters most to you!
- [Service Prioritization](https://docs.causely.ai/configuration/service-tiers.md): Assign service tiers to focus your reliability efforts on what matters most.
- [Symptom Delay](https://docs.causely.ai/configuration/symptom-delay.md): Configure activation and deactivation delays for service symptoms to avoid reacting to temporary spikes
- [Thresholds for Service Symptoms](https://docs.causely.ai/configuration/thresholds.md): Configure thresholds for service and infrastructure symptoms and SLI-based SLO evaluation
- [Architecture](https://docs.causely.ai/getting-started/architecture.md): Understanding Causely's deployment architecture and component structure
- [First-Time Usage Guide](https://docs.causely.ai/getting-started/first-time-usage.md): Learn how to use Causely for the first time. Discover how to view root causes, analyze system issues, and get AI-powered insights for your cloud in...
- [Start with Causely](https://docs.causely.ai/getting-started/getting-started.md): Learn how to set up Causely quickly and efficiently. Follow our step-by-step guide to create your account, install the Causely CLI, and configure d...
- [Supported Technologies](https://docs.causely.ai/getting-started/supported-technologies.md): Quick reference of all technologies supported by Causely
- [Accelerate Resolution](https://docs.causely.ai/goals/accelerate-resolution.md): Get precise root cause insights during incidents to resolve issues faster.
- [Optimize Performance](https://docs.causely.ai/goals/optimize-performance.md): Continuously improve system performance with actionable insights.
- [What are your goals?](https://docs.causely.ai/goals/goals.md): Discover how Causely helps you achieve your reliability goals and move from reactive troubleshooting to proactive reliability.
- [Proactively Prevent Incidents](https://docs.causely.ai/goals/prevent-incidents.md): Identify emerging risks before they impact your services and SLOs.
- [Scale Reliability](https://docs.causely.ai/goals/scale-reliability.md): Maintain reliability across complex, fast-changing systems at scale.
- [Understand System Behavior](https://docs.causely.ai/goals/understand-system-behavior.md): Gain deep insights into why your systems behave the way they do.
- [Automate Remediation](https://docs.causely.ai/in-action/automate-remediation.md): Automate remediation for resource contention root causes—including CPU, memory, and noisy-neighbor issues—directly from the Causely UI.
- [Feature Demos](https://docs.causely.ai/in-action/feature-demos.md): This page links to Causely feature demos to help you understand what you can do and what to expect with Causely.
- [Causely In Action](https://docs.causely.ai/in-action/in-action.md): Explore the day-to-day views powered by the Causely engine: Welcome Page, Topology, Root Causes, and Feature Demos.
- [Reliability Delta](https://docs.causely.ai/in-action/reliability-delta.md): Compare system snapshots to determine if reliability improved or regressed
- [Topology](https://docs.causely.ai/in-action/topology.md): Explore entities discovered by the Causely engine, filter by scope, severity, and type, search, and inspect detailed views such as Summary, Root Ca...
- [Welcome Page](https://docs.causely.ai/in-action/welcome-page.md): Start your day with a snapshot of urgent root causes, and insights from the last 24 hours.
- [Causely Documentation](https://docs.causely.ai/index.md): AI-powered reliability engine documentation
- [Next Steps](https://docs.causely.ai/installation/_common/next-steps.md): Visit the [Customize your installation](/installation/customize) page to learn more about customizing your installation.
- [Prerequisites](https://docs.causely.ai/installation/_common/prerequisites.md): Before you begin, make sure your environment meets the following requirements:
- [Retrieve Your Access Token](https://docs.causely.ai/installation/_common/retrieve-your-access-token.md): 1. Visit https://portal.causely.app and log in.
- [Review Discovery](https://docs.causely.ai/installation/_common/review-discovery.md): To verify the agent is successfully installed navigate to the [Integrations Agents view](https://portal.causely.app/integrations?tab=agents).
- [Argo CD Installation](https://docs.causely.ai/installation/argocd.md): Install Causely using Argo CD GitOps
- [CLI Installation](https://docs.causely.ai/installation/cli.md): CLI Installation
- [Customize your installation](https://docs.causely.ai/installation/customize.md): Customize your installation
- [Standalone Docker Host Installation](https://docs.causely.ai/installation/docker.md): Install Causely on a standalone Docker host
- [FluxCD Installation](https://docs.causely.ai/installation/flux.md): Install Causely using FluxCD GitOps
- [Helm Installation](https://docs.causely.ai/installation/helm.md): Helm Installation
- [Network Allowlisting](https://docs.causely.ai/installation/network-allowlisting.md): Network requirements and URL allowlisting for Causely
- [Nomad Installation](https://docs.causely.ai/installation/nomad.md): Install Causely on HashiCorp Nomad
- [Causely Operator](https://docs.causely.ai/installation/operator.md): Version management for Causely components
- [Installation Overview](https://docs.causely.ai/installation/installation.md): Deploy Causely's lightweight agents for real-time causal analytics. Choose from Helm, CLI, Docker, Nomad, FluxCD, or Argo CD installation options.
- [API Tokens](https://docs.causely.ai/manage/administration/api-tokens.md): Create and manage personal and tenant-wide API tokens in Causely
- [Audit Logs](https://docs.causely.ai/manage/administration/audit-logs.md): Review a log of administrative activity in your Causely workspace
- [Administration](https://docs.causely.ai/manage/administration/index.md): Manage users, SSO, audit logs, and API tokens in Causely
- [Single Sign-On (SSO)](https://docs.causely.ai/manage/administration/sso.md): Configure SSO for your Causely workspace
- [User Management](https://docs.causely.ai/manage/administration/user-management.md): Invite users to your Causely workspace and assign roles
- [Manage Causely](https://docs.causely.ai/manage/manage.md): Installation, telemetry connections, integrations, and configuration for Causely
- [Add More Telemetry Step](https://docs.causely.ai/quickstart-guides/_common/add-more-telemetry-step.md): <Step number="add-telemetry">
- [Get Installation Command Step](https://docs.causely.ai/quickstart-guides/_common/get-installation-command-step.md): <Step number="1">
- [Other Platforms Note](https://docs.causely.ai/quickstart-guides/_common/other-platforms-note.md): :::tip Other Platforms Supported
- [AWS Quickstart Guide](https://docs.causely.ai/quickstart-guides/aws.md): Get started with Causely on AWS
- [Azure Quickstart Guide](https://docs.causely.ai/quickstart-guides/azure.md): Get started with Causely on Azure
- [Datadog Quickstart Guide](https://docs.causely.ai/quickstart-guides/datadog.md): Get started with Causely using Datadog
- [Dynatrace Quickstart Guide](https://docs.causely.ai/quickstart-guides/dynatrace.md): Get started with Causely using Dynatrace
- [GCP Quickstart Guide](https://docs.causely.ai/quickstart-guides/gcp.md): Get started with Causely on GCP
- [Instana Quickstart Guide](https://docs.causely.ai/quickstart-guides/instana.md): Get started with Causely using Instana
- [Kubernetes Quickstart Guide](https://docs.causely.ai/quickstart-guides/kubernetes.md): Get started with Causely on Kubernetes in minutes
- [OpenTelemetry Quickstart Guide](https://docs.causely.ai/quickstart-guides/opentelemetry.md): Get started with Causely using OpenTelemetry
- [Applications](https://docs.causely.ai/reference/entity-types/applications.md): Application Entity Types
- [Compute](https://docs.causely.ai/reference/entity-types/compute.md): Compute entity types
- [Databases](https://docs.causely.ai/reference/entity-types/databases.md): Database entity types
- [Data Pipeline](https://docs.causely.ai/reference/entity-types/datapipeline.md): Data Pipeline Entity Types
- [Messaging](https://docs.causely.ai/reference/entity-types/messaging.md): Messaging Entity Types
- [Entity Types Overview](https://docs.causely.ai/reference/entity-types.md): Overview of discovered entity types in Causely
- [Services](https://docs.causely.ai/reference/entity-types/services.md): Service Entity Types
- [Applications](https://docs.causely.ai/reference/root-causes/applications.md): Root causes caused by code issues, including bugs, logic errors, and inefficient algorithms.
- [Data Pipeline](https://docs.causely.ai/reference/root-causes/datapipeline.md): Root causes degrading performance of data flow, API endpoints, and inter-system data processing.
- [Infrastructure](https://docs.causely.ai/reference/root-causes/infrastructure.md): Root causes caused by infrastructure resources such as compute, networking, and storage.
- [Types of inferable root causes](https://docs.causely.ai/reference/root-causes.md): Overview of the types of root causes that Causely can infer
- [Release Management](https://docs.causely.ai/reference/root-causes/release.md): Root causes triggered by code changes, deployments, and version updates.
- [Services](https://docs.causely.ai/reference/root-causes/services.md): Root causes caused by service bottleneck or malfunctioning, either internal or third-party external services.
- [Applications](https://docs.causely.ai/reference/symptoms/applications.md): Symptoms related to application workloads and compute specifications
- [Data Pipeline](https://docs.causely.ai/reference/symptoms/datapipeline.md): Symptoms related to operations, access patterns, and data flow
- [Infrastructure](https://docs.causely.ai/reference/symptoms/infrastructure.md): Symptoms related to compute resources, storage, and networking
- [Symptoms](https://docs.causely.ai/reference/symptoms.md): Overview of all symptoms that Causely can detect
- [Services](https://docs.causely.ai/reference/symptoms/services.md): Symptoms related to services and load balancers
- [Terminology](https://docs.causely.ai/reference/terminology.md): Terminology used in Causely
- [Latest Releases](https://docs.causely.ai/release-notes/release-notes.md): Stay up-to-date with Causely's latest features, improvements, and bug fixes. Discover new capabilities for root cause analysis, integrations, and p...
- [Security](https://docs.causely.ai/security/security.md): Causely security overview
- [Alertmanager](https://docs.causely.ai/telemetry-sources/alertmanager.md): Ingest Prometheus Alertmanager alerts into Causely for causal reasoning and faster triage.
- [Application Instrumentation](https://docs.causely.ai/telemetry-sources/application-instrumentation.md): Analyze applications written in Java, Python, Golang, and other languages using telemetry collection
- [Amazon Web Services (AWS)](https://docs.causely.ai/telemetry-sources/aws.md): Comprehensive AWS integration for identifying and resolving infrastructure and service performance issues across ECS, Lambda, RDS, MSK, Load Balanc...
- [Azure](https://docs.causely.ai/telemetry-sources/azure.md): Integrate Azure with Causely
- [Backstage Integration](https://docs.causely.ai/telemetry-sources/backstage.md): Integrate Backstage software catalog with Causely to enrich Kubernetes services with ownership and component metadata
- [Checkly](https://docs.causely.ai/telemetry-sources/checkly.md): Identify and resolve external monitoring and synthetic testing issues with Causely's native integration. Identify API failures, performance degrada...
- [ClickHouse](https://docs.causely.ai/telemetry-sources/clickhouse.md): Identify and resolve ClickHouse database performance issues with Causely's native integration. Detect table mutations, slow queries, and connection...
- [Confluent](https://docs.causely.ai/telemetry-sources/confluent.md): Monitor and troubleshoot Confluent Cloud streaming platform performance issues with Causely's native integration. Identify consumer lag, topic bott...
- [Datadog](https://docs.causely.ai/telemetry-sources/datadog.md): Integrate Datadog with Causely
- [Docker](https://docs.causely.ai/telemetry-sources/docker.md): Get comprehensive visibility into your Docker infrastructure with Causely's native integration. Monitor containers, hosts, workloads, and applicati...
- [Dynatrace](https://docs.causely.ai/telemetry-sources/dynatrace.md): Integrate Dynatrace with Causely
- [eBPF](https://docs.causely.ai/telemetry-sources/ebpf.md): Learn how Causely uses eBPF technology to automatically instrument applications and collect telemetry data with zero code changes and minimal overh...
- [Elasticsearch](https://docs.causely.ai/telemetry-sources/elasticsearch.md): Integrate Elasticsearch with Causely to retrieve logs and analyze cluster performance. Use Causely to correlate logs stored in Elasticsearch with s...
- [GCP](https://docs.causely.ai/telemetry-sources/gcp.md): Integrate GCP with Causely
- [Grafana](https://docs.causely.ai/telemetry-sources/grafana.md): Integrate Grafana with Causely
- [groundcover](https://docs.causely.ai/telemetry-sources/groundcover.md): Integrate groundcover with Causely
- [incident.io Integration](https://docs.causely.ai/telemetry-sources/incident-io.md): Integrate incident.io with Causely
- [Instana](https://docs.causely.ai/telemetry-sources/instana.md): Integrate IBM Instana Observability with Causely
- [Istio](https://docs.causely.ai/telemetry-sources/istio.md): Integrate Istio with Causely
- [Kubernetes](https://docs.causely.ai/telemetry-sources/kubernetes.md): Get comprehensive visibility into your Kubernetes infrastructure with Causely's native integration. Monitor clusters, nodes, pods, services, and wo...
- [MySQL](https://docs.causely.ai/telemetry-sources/mysql.md): Identify and resolve MySQL database performance issues with Causely's native integration. Identify table malfunctions, slow queries and connection ...
- [Nobl9](https://docs.causely.ai/telemetry-sources/nobl9.md): Integrate Nobl9 with Causely
- [Nomad](https://docs.causely.ai/telemetry-sources/nomad.md): Get comprehensive visibility into your Nomad infrastructure with Causely's native integration. Monitor jobs, tasks, allocations, and nodes with aut...
- [Odigos](https://docs.causely.ai/telemetry-sources/odigos.md): Integrate Odigos with Causely
- [Integrate OpenTelemetry Traces](https://docs.causely.ai/telemetry-sources/opentelemetry.md): Learn how to configure and use OpenTelemetry traces with Causely to automatically discover service dependencies and monitor communication signals i...
- [Connect Telemetry Sources for Causal Analysis](https://docs.causely.ai/telemetry-sources/telemetry-sources.md): Connect OpenTelemetry, eBPF, and observability data sources to Causely's reliability engine for comprehensive causal analysis and automated causal ...
- [PostgreSQL](https://docs.causely.ai/telemetry-sources/postgresql.md): Identify and resolve PostgreSQL database performance issues with Causely's native integration. Identify table malfunctions, slow queries and connec...
- [Prometheus](https://docs.causely.ai/telemetry-sources/prometheus.md): Integrate Prometheus with Causely
- [Snowflake](https://docs.causely.ai/telemetry-sources/snowflake.md): Integrate Snowflake with Causely
- [Splunk](https://docs.causely.ai/telemetry-sources/splunk.md): Integrate Splunk with Causely to retrieve logs and enhance root cause analysis. Use Causely to correlate logs stored in Splunk with service-level i...
- [Custom Workflows](https://docs.causely.ai/workflows/custom-workflows.md): Send Causely notifications to any endpoint (GitHub, Linear, n8n, or your own webhook) via CauselyBot
- [Generic Webhook](https://docs.causely.ai/workflows/generic-webhook.md): Send Causely notifications to any HTTP endpoint via a generic webhook
- [Grafana Alertmanager](https://docs.causely.ai/workflows/grafana-alertmanager.md): Integrate Grafana Alertmanager with Causely
- [Causely Grafana Plugin](https://docs.causely.ai/workflows/grafana-plugin.md): Integrate Grafana Cloud or self-hosted with Causely
- [incident.io Integration](https://docs.causely.ai/workflows/incident-io.md): Automatically create and resolve incidents in incident.io from causal analysis by Causely
- [Microsoft Teams](https://docs.causely.ai/workflows/microsoft-teams.md): Send Causely insights Microsoft Teams
- [Notification Payload](https://docs.causely.ai/workflows/notification-payload.md): Notification Payload Example for Webhook Integrations
- [Push Causal Insights Into Your Workflow](https://docs.causely.ai/workflows/workflows.md): Workflow Integrations and Webhooks
- [Prometheus Alertmanager](https://docs.causely.ai/workflows/prometheus-alertmanager.md): Integrate Prometheus Alertmanager with Causely
- [Slack Notifications](https://docs.causely.ai/workflows/slack.md): Send Causely insights to Slack
- [Splunk On-Call](https://docs.causely.ai/workflows/splunk-on-call.md): Integrate Splunk On-Call with Causely
- [Managed Notifications](https://docs.causely.ai/workflows/ui-notifications.md): Configure notification in the Causely UI