# Firetiger

> Firetiger is a REST API platform (JSON-over-POST, AIP conventions, Basic auth) for configuring autonomous agents that monitor software systems using telemetry data and connected tools.

- [Full documentation](https://docs.firetiger.com/llms-full.txt): all pages concatenated into a single file


## Concepts

- [Agents](https://docs.firetiger.com/concepts/agents.txt): How agents work: creation, triggers (webhook/scheduled/post-deploy), sessions, memory, and tools
- [Services](https://docs.firetiger.com/concepts/services.txt): Services, Dimensions, Indicators, Objectives, Service Cells, and Cell Health — how Firetiger models and monitors system health
- [Integrations](https://docs.firetiger.com/concepts/integrations.txt): How connections, ingest sources, and credentials work to give agents access to external systems
- [Providers](https://docs.firetiger.com/concepts/providers.txt): Providers model external infrastructure and dependencies that Firetiger can reason about and monitor
- [Telemetry](https://docs.firetiger.com/concepts/telemetry.txt): OpenTelemetry data ingestion, service-based organization, structured logs, and schema inference
- [Deployments](https://docs.firetiger.com/concepts/deployments.txt): Deployment tracking via GitHub webhooks or API, git ancestry matching, and post-deploy monitoring
- [Issues](https://docs.firetiger.com/concepts/issues.txt): Per-agent issue tracking: automatic creation, workflow states, deduplication, and notification routing
- [Knowledge](https://docs.firetiger.com/concepts/knowledge.txt): Knowledge resources: services, flows, customers, notes, issues, and Firetiger.md

## Guides

- [OpenTelemetry Integration](https://docs.firetiger.com/guides/opentelemetry.txt): Configure OTLP export to Firetiger from OpenTelemetry collectors or application SDKs
- [MCP Server](https://docs.firetiger.com/guides/mcp-server.txt): Connect Claude Desktop, Cursor, or Claude Code to Firetiger via the MCP server endpoint
- [Agent Webhooks](https://docs.firetiger.com/guides/agent-webhooks.txt): How to invoke agents via HTTP webhook using a stable webhook URL
- [Create a Custom Slack Handle for an Agent](https://docs.firetiger.com/guides/agent-slack-handles.txt): Create a custom Slack @handle that starts a specific Firetiger agent from selected channels
- [BigQuery Integration](https://docs.firetiger.com/guides/bigquery.txt): Query Firetiger Iceberg tables from BigQuery using BigLake on AWS deployments
- [Datadog Alerts](https://docs.firetiger.com/guides/datadog-alerts.txt): Fire off a Firetiger investigation (or a custom agent) automatically when a Datadog monitor alerts
- [incident.io Workflows](https://docs.firetiger.com/guides/incident-io-workflows.txt): Trigger Firetiger agents automatically from incident.io workflow webhooks
- [Change Monitor](https://docs.firetiger.com/guides/change-monitor.txt): Per-PR change monitoring: PR tagging, monitoring plans, scheduled deploy checks, and Slack DM updates
- [Fixing issues with coding agents](https://docs.firetiger.com/guides/fixing-issues-with-coding-agents.txt): Launch Cursor, Devin, Tembo, Replicas, or Coder on any Firetiger issue from the Fix dropdown; how sessions run, land as PRs, and close the issue
- [Impact Reports](https://docs.firetiger.com/guides/impact-reports.txt): Weekly per-engineer Impact Reports: what your shipped changes did in production, delivered by email and in the Firetiger UI
- [Connect to a Private Database with Tailscale](https://docs.firetiger.com/guides/tailscale-private-network.txt)
- [GCP Cloud Build](https://docs.firetiger.com/guides/gcp-cloud-build.txt): Register Cloud Build deployments with Firetiger to enable Change Monitor
- [Investigate GCP Error Reporting](https://docs.firetiger.com/guides/gcp-error-reporting.txt): Trigger a Firetiger investigation automatically when GCP Error Reporting detects an error
- [Custom Agent Skills](https://docs.firetiger.com/guides/skills.txt): Load your own agentskills.io-format skills from a GitHub repository into Firetiger's agents

## Deployment Options

- [SaaS](https://docs.firetiger.com/deploy/saas.txt): Firetiger SaaS: fully managed hosted deployment with no infrastructure to maintain
- [BYOC: AWS](https://docs.firetiger.com/deploy/aws.txt): BYOC AWS setup: cross-account IAM role via CloudFormation and Bedrock model access
- [BYOC: GCP](https://docs.firetiger.com/deploy/gcp.txt): BYOC GCP setup: project creation, billing, required APIs, and IAM for Firetiger service account

## Account Management

- [Google Workspace](https://docs.firetiger.com/sso/google-workspace.txt): Configure Google Workspace as a SAML identity provider for SSO login to Firetiger
- [API Keys](https://docs.firetiger.com/account-management/api_keys.txt): Create, use, and revoke API keys for programmatic HTTP Basic auth access to the Firetiger API

## Optional

## Integrations

- [PostgreSQL](https://docs.firetiger.com/integrations/databases/postgres.txt): Connect agents to PostgreSQL databases for read-only querying with SSL, role-based access, and read-only mode
- [MySQL](https://docs.firetiger.com/integrations/databases/mysql.txt): Connect agents to MySQL databases for read-only querying with SSL modes and session-level read-only enforcement
- [ClickHouse](https://docs.firetiger.com/integrations/databases/clickhouse.txt): Connect agents to ClickHouse analytical databases for read-only querying with TLS and native protocol
- [Iceberg](https://docs.firetiger.com/integrations/databases/iceberg.txt): Connect agents to an Apache Iceberg REST catalog for SQL queries against the Firetiger data lake or external Iceberg warehouses
- [Trino](https://docs.firetiger.com/integrations/databases/trino.txt): Connect agents to a Trino coordinator for federated SQL across catalogs (Hive, Iceberg, Postgres, etc.)
- [Elasticsearch](https://docs.firetiger.com/integrations/databases/elasticsearch.txt): Connect agents to an Elasticsearch cluster's SQL endpoint for read-only querying with API-key or basic auth
- [Databricks](https://docs.firetiger.com/integrations/databases/databricks.txt): Let agents query Databricks Delta Lake tables in Unity Catalog through the Databricks managed MCP server
- [AWS](https://docs.firetiger.com/integrations/infrastructure/aws.txt): Connect to AWS via IAM role assumption (STS AssumeRole) with CloudFormation setup for cross-account access
- [GCP](https://docs.firetiger.com/integrations/infrastructure/gcp.txt): Connect to GCP via service account key authentication for access to Google Cloud Platform resources
- [AWS CloudWatch Logs](https://docs.firetiger.com/integrations/infrastructure/aws-cloudwatch.txt): Ingest AWS CloudWatch Logs into Firetiger via Terraform or CloudFormation Lambda deployment
- [AWS ECS Events](https://docs.firetiger.com/integrations/infrastructure/aws-ecs.txt): Ingest AWS ECS task lifecycle events including container failures and OOMKilled events
- [CloudFront Kinesis Integration](https://docs.firetiger.com/integrations/infrastructure/cloudfront-kinesis.txt): Stream CloudFront real-time logs to Firetiger via Kinesis Data Stream and Firehose with field mapping
- [Cloudflare Workers Integration](https://docs.firetiger.com/integrations/infrastructure/cloudflare-workers.txt): Export Cloudflare Workers traces and logs to Firetiger via built-in OpenTelemetry OTLP destinations
- [Cloudflare Logpush Integration](https://docs.firetiger.com/integrations/infrastructure/cloudflare-logpush.txt): Ingest Cloudflare HTTP request logs via Logpush direct HTTP destination
- [Convex Log Streams](https://docs.firetiger.com/integrations/infrastructure/convex.txt): Forward Convex function logs to Firetiger via Log Streams webhooks with HMAC-SHA256 signature verification
- [Vercel](https://docs.firetiger.com/integrations/infrastructure/vercel.txt): Send logs and traces from Vercel to Firetiger via Vercel Drains
- [Fastly](https://docs.firetiger.com/integrations/infrastructure/fastly.txt): Send logs from Fastly to Firetiger via the Fastly HTTPS log endpoint
- [GitHub](https://docs.firetiger.com/integrations/developer-tools/github.txt): Install the Firetiger GitHub App for codebase search context during investigations and event ingestion
- [GitHub Webhooks](https://docs.firetiger.com/integrations/developer-tools/github-webhook.txt): Automatically ingest GitHub webhook events (pushes, PRs, workflow runs) into the github_events table
- [Incident.io](https://docs.firetiger.com/integrations/developer-tools/incident-io.txt): Connect agents to incident.io for creating, listing, and editing incidents via the HTTP connection type
- [Cursor](https://docs.firetiger.com/integrations/developer-tools/cursor.txt): Trigger Cursor cloud agents to fix Firetiger issues, directly from the issue detail page
- [Pylon](https://docs.firetiger.com/integrations/developer-tools/pylon.txt): Connect agents to Pylon for creating internal issues and looking up customer accounts
- [WorkOS](https://docs.firetiger.com/integrations/developer-tools/workos.txt): Give Firetiger agents access to WorkOS user management, SSO, directory sync, and audit logs
- [Inspect](https://docs.firetiger.com/integrations/developer-tools/inspect.txt): Trigger Ramp Inspect coding-agent sessions to fix Firetiger issues, directly from the issue detail page
- [Linear](https://docs.firetiger.com/integrations/developer-tools/linear.txt): Connect a Linear workspace so agents can create, update, and query issues, comments, and projects
- [Clerk](https://docs.firetiger.com/integrations/developer-tools/clerk.txt): Connect agents to Clerk's Backend API for user, organization, and session management
- [Vanta](https://docs.firetiger.com/integrations/developer-tools/vanta.txt): Connect agents to Vanta's compliance API via OAuth Client Credentials for evidence and control monitoring
- [Tembo](https://docs.firetiger.com/integrations/developer-tools/tembo.txt): Launch Tembo coding agents from Firetiger — ad-hoc tasks or pre-configured automations triggered by issues
- [Devin](https://docs.firetiger.com/integrations/developer-tools/devin.txt): Launch Devin, Cognition's cloud coding agent, to fix Firetiger issues from the Fix button or automatically via Autofix
- [Slack](https://docs.firetiger.com/integrations/communications/slack.txt): Connect a Slack workspace so agents can send notifications and alerts to channels
- [SendGrid Event Webhooks](https://docs.firetiger.com/integrations/communications/sendgrid-webhook.txt): Ingest SendGrid email event webhooks into per-event-type tables for delivery, bounce, and engagement tracking
- [Google Postmaster Tools](https://docs.firetiger.com/integrations/communications/google-postmaster.txt): Connect agents to Google Postmaster Tools for email deliverability metrics, domain reputation, and spam rates
- [Vector](https://docs.firetiger.com/integrations/observability/vector.txt): Configure a Vector HTTP sink to send logs, metrics, or traces to Firetiger with basic auth
- [Datadog Agent](https://docs.firetiger.com/integrations/observability/datadog.txt): Forward APM traces and metrics from a Datadog Agent to Firetiger, with single-destination or dual-write modes
- [DataDog Log Forwarding](https://docs.firetiger.com/integrations/observability/datadog-forward.txt): Forward logs from Datadog to Firetiger via a custom log destination with severity and timestamp mapping
- [GCP Cloud Monitoring](https://docs.firetiger.com/integrations/observability/gcp-cloud-monitoring.txt): Give Firetiger agents direct access to GCP Cloud Monitoring metrics for infrastructure investigation
- [PromQL](https://docs.firetiger.com/integrations/observability/promql.txt): Query Prometheus-compatible metrics APIs from Firetiger agents using PromQL
- [PagerDuty](https://docs.firetiger.com/integrations/observability/pagerduty.txt): Connect agents to PagerDuty for incident, service, and on-call lookups via API token authentication
- [HTTP](https://docs.firetiger.com/integrations/custom/http.txt): Connect agents to any REST API via HTTP with configurable routes, authentication, and response limits
- [Send Email via Webhook](https://docs.firetiger.com/integrations/custom/email-webhook.txt): Configure guarded customer email delivery to a fixed webhook endpoint with optional Slack review notifications
- [MCP Servers](https://docs.firetiger.com/integrations/custom/mcp.txt): Connect agents to external MCP servers (GitHub, Linear, Notion, Sentry, etc.) via OAuth for tool access
- [OpenAPI](https://docs.firetiger.com/integrations/custom/openapi.txt): Connect agents to any REST API with an OpenAPI specification for automatic endpoint discovery
- [gRPC](https://docs.firetiger.com/integrations/custom/grpc.txt): Connect agents to a gRPC, ConnectRPC, or gRPC-Web service. Discovery uses server reflection; invocation uses buf curl with auth injected by the network proxy
- [GraphQL](https://docs.firetiger.com/integrations/custom/graphql.txt): Connect agents to any GraphQL endpoint. Self-documents via introspection; auth is injected by the network proxy
- [Web Search](https://docs.firetiger.com/integrations/custom/web-search.txt): Enable web search for agents via Brave Search. Configured as an org-level toggle — no per-connection credentials
- [AWS VPC Peering](https://docs.firetiger.com/integrations/networking/aws-vpc-peering.txt): Set up VPC peering between your AWS VPC and a Firetiger BYOC deployment for private network access
- [Tailscale](https://docs.firetiger.com/integrations/networking/tailscale.txt)
- [SOCKS5](https://docs.firetiger.com/integrations/networking/socks5.txt)

## API Reference

- [Agents](https://docs.firetiger.com/api-reference/agents.txt): CRUD agents and sessions, send and read messages, and retrieve artifacts via the AgentService API
- [Connections](https://docs.firetiger.com/api-reference/connections.txt): Read-only API to list and inspect configured connections and available connection types
- [Customers](https://docs.firetiger.com/api-reference/customers.txt): CRUD customer resources identified by external_id, with display names and associated runbooks
- [Deployments](https://docs.firetiger.com/api-reference/deployments.txt): Track deployment events and deployment monitor evaluations via the Deployments API
- [Investigations](https://docs.firetiger.com/api-reference/investigations.txt): Create and manage agent-driven investigation sessions that diagnose system issues
- [Issues](https://docs.firetiger.com/api-reference/issues.txt): Read agent-detected issues and configure notification policies for alert routing
- [Monitoring Plans](https://docs.firetiger.com/api-reference/monitoring-plans.txt): API for PR-based deployment monitoring plans, status updates, and per-environment run results
- [Coding Agents](https://docs.firetiger.com/api-reference/coding-agents.txt): Launch and manage coding-agent sessions against Firetiger issues
- [Notes](https://docs.firetiger.com/api-reference/notes.txt): CRUD free-form notes that capture observations, tool outputs, and investigation context
- [Tags](https://docs.firetiger.com/api-reference/tags.txt): CRUD tags for organizing and filtering agents
- [Runbooks](https://docs.firetiger.com/api-reference/runbooks.txt): CRUD runbooks with structured operating procedures, associated connections, and enabled tools
- [Triggers](https://docs.firetiger.com/api-reference/triggers.txt): CRUD and invoke triggers that start agent sessions on cron schedules, manual, or post-deploy events
- [Agent SLOs](https://docs.firetiger.com/api-reference/agent-slos.txt): Define and track Service Level Objectives for agents via the AgentSlosService API
- [Auth](https://docs.firetiger.com/api-reference/auth.txt): Inspect the authenticated request identity with the AuthService API
- [Notifications](https://docs.firetiger.com/api-reference/notifications.txt): Subscribe to and publish real-time notifications via the NotificationService API
- [Sent Emails](https://docs.firetiger.com/api-reference/sent-emails.txt): Read-only API to list emails sent by the Firetiger platform via the SentEmailService
- [Agent](https://docs.firetiger.com/api-reference/types/agent.txt): Agent resource type with name, title, system prompt, connections, state, and model configuration
- [Session](https://docs.firetiger.com/api-reference/types/session.txt): Session resource type with status, conclusion, artifacts, and SessionDescription summary fields
- [Connection](https://docs.firetiger.com/api-reference/types/connection.txt): Connection resource type with connection details, tool configurations, and all ConnectionType/Tool enums
- [Customer](https://docs.firetiger.com/api-reference/types/customer.txt): Customer resource type with external_id, display name, description, runbook, and workload summary
- [Deployment](https://docs.firetiger.com/api-reference/types/deployment.txt): Deployment resource type with source, status, labels, and related DeploymentMonitorEvaluation type
- [Investigation](https://docs.firetiger.com/api-reference/types/investigation.txt): Investigation resource type with display name, description, and status (executing or waiting)
- [Issue](https://docs.firetiger.com/api-reference/types/issue.txt): Issue and IssueNotificationPolicy types with states, severity, routing, and notification config
- [DeploymentEnvironment](https://docs.firetiger.com/api-reference/types/deployment-environment.txt): DeploymentEnvironment resource type with monitoring toggle and human-authored description
- [Monitoring Plan](https://docs.firetiger.com/api-reference/types/monitoring-plan.txt): MonitoringPlan type with PR origin, activation trigger, plan content, and per-environment outcomes
- [Note](https://docs.firetiger.com/api-reference/types/note.txt): Note resource type with display name, content, and optional tool name and arguments
- [Runbook](https://docs.firetiger.com/api-reference/types/runbook.txt): Runbook resource type with text instructions and connection references with enabled tool lists
- [Tag](https://docs.firetiger.com/api-reference/types/tag.txt): Tag resource type for organizing and filtering agents
- [Trigger](https://docs.firetiger.com/api-reference/types/trigger.txt): Trigger resource type with cron, manual, and post-deploy configurations and activation state
- [Activity](https://docs.firetiger.com/api-reference/types/activity.txt): Union type for agent session events: user messages, assistant messages, errors, and external inputs
- [Slack Handle](https://docs.firetiger.com/api-reference/types/slack-handle.txt): Slack handle resource type — reserves a workspace @-name for Firetiger
- [User Identity And Change Monitor Notifications](https://docs.firetiger.com/api-reference/types/user-notification.txt): User identity and Change Monitor notification preference resource types
- [Role](https://docs.firetiger.com/api-reference/types/role.txt): Role resource type: an org-scoped bundle of permissions
- [SkillsBundle](https://docs.firetiger.com/api-reference/types/skills-bundle.txt): SkillsBundle resource type referencing a GitHub connection and a directory of agentskills.io skills
- [Network Profiles](https://docs.firetiger.com/api-reference/network-profiles.txt): Named allow-lists of egress domains for the bash tool
- [Slack Handles](https://docs.firetiger.com/api-reference/slack-handles.txt): CRUD Slack handles — reserve @-names for Firetiger agents in a Slack workspace
- [Indicators](https://docs.firetiger.com/api-reference/indicators.txt): Define and reuse ConfitSQL-backed timeseries measurements via the IndicatorsService API
- [Flows](https://docs.firetiger.com/api-reference/flows.txt): Define and inspect Flow resources — multi-service user journeys agents reason about
- [Objectives](https://docs.firetiger.com/api-reference/objectives.txt): Define Service Level Objectives over Indicators via the goals.v2 ObjectivesService API
- [Providers](https://docs.firetiger.com/api-reference/providers.txt): Maintain Provider resources — external infrastructure and dependencies agents reason about
- [Services](https://docs.firetiger.com/api-reference/services.txt): Maintain a catalog of Service resources — components / applications agents reason about
- [Billing](https://docs.firetiger.com/api-reference/billing.txt): Metering usage and overage for the current billing period plus historical per-agent breakdowns
- [Network Transports](https://docs.firetiger.com/api-reference/network-transports.txt): Overlay networks (Tailscale) used to reach customer-side private systems
- [Autofix](https://docs.firetiger.com/api-reference/autofix.txt): Configure automatic coding-agent fixes for Actionable issues
- [Slack](https://docs.firetiger.com/api-reference/slack.txt): Send Slack messages through a connection with membership-based channel resolution and idempotent delivery
- [Skills Bundles](https://docs.firetiger.com/api-reference/skills-bundles.txt): Configure GitHub repositories of agentskills.io skills to expose to your agents
- [Roles](https://docs.firetiger.com/api-reference/roles.txt): Manage roles and assign them to organization members