How OnePatch works

OnePatch has three parts: the telemetry you send, the agent that reads it, and the artifacts the agent produces. This page explains the model so the rest of the documentation reads clearly.

​

Telemetry in

Your application sends OpenTelemetry — traces, metrics, and logs — to your workspace’s ingest endpoint. OnePatch stores every signal and makes it queryable. You do not configure storage, schemas, or retention; you point your exporter at the endpoint and the data lands. This is the only thing you have to set up by hand, and you do it once. See Getting started for the steps.

​

The agent over your data

Your workspace runs an AI agent with read access to all of your telemetry and to the repositories you connect. You interact with it in chat. It is the single interface to the product — there is no separate query builder, alert editor, or dashboard designer. When you ask a question, the agent queries your telemetry directly and answers from the data. When you ask it to watch something or visualize something, it writes the monitor or dashboard for you.

​

Monitors and dashboards out

The agent produces two kinds of durable artifact:

• A dashboard is a live view of your telemetry. The agent writes it, and it refreshes as new data arrives.
• A monitor is a small program that checks a window of your telemetry on a schedule and reports whether it is healthy, firing, or unknown.

Both are stored as code in your workspace and versioned in git, so every change is a commit you can read and revert. A monitor goes live when the agent commits and pushes it — there is no separate publish step. Monitors and dashboards covers this in detail.

​

What the agent does when something breaks

A monitor can be armed. When an armed monitor fires, OnePatch opens an incident and the agent triages it — it investigates the firing, and either tunes the monitor if it was a false alarm or opens a pull request if it found a real problem. Notifications land in your #onepatch-alerts Slack channel. Incidents and Slack explains the full path.

​

Vocabulary

These terms appear throughout the product and the docs: