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

# Optimize — how it works

> The four lenses on a running fleet — reliability, quality, cost, and portability — and which surface answers each.

Building and running agents gets work done; **Optimize** is how you find out whether it was done
well. The Komodor Agentic Operation Platform (KAOP) measures a running fleet through four
independent lenses, each answering a question the others cannot. This page explains what each lens
measures, which surface answers it, and the order to read them in.

## Four lenses, four questions

An agent can be healthy and wrong, correct and ruinously expensive, or cheap and invisible outside
KAOP. Those are four separate failure modes, so they get four separate readings.

| Lens            | The question                            | Where you answer it                                                                                                                                                                                         |
| --------------- | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Reliability** | Is it running, and is it failing?       | [Fleet health](/manage-your-agents/optimize/fleet-health) · Insights                                                                                                                                        |
| **Quality**     | Was the output actually good?           | [Evaluations](/manage-your-agents/optimize/evaluations) · [Model Evaluation](/manage-your-agents/optimize/model-evaluation) · [Continuous Improvement](/manage-your-agents/optimize/continuous-improvement) |
| **Cost**        | What did it cost, and is that worth it? | [Agent spend attribution](/manage-your-agents/optimize/agent-spend-attribution)                                                                                                                             |
| **Portability** | Can the rest of my tooling see this?    | [Observability & OTel export](/manage-your-agents/optimize/observability-otel-export) · [Knowledge graph](/manage-your-agents/optimize/knowledge-graph)                                                     |

<Info>
  **Reliability and quality are the pair worth internalizing.** A failing run announces itself — it has
  a status, a category, and a place to look. A wrong run does not: it succeeds, costs what it always
  costs, and leaves no operational trace at all. Reliability tooling will never find it. That gap is
  why quality gets its own instruments rather than being folded into fleet monitoring.
</Info>

## Reliability

Reliability starts from presence and run outcomes, and both are computed rather than declared.
**Fleet health** gives you the fleet's live state — who is online, who has capacity, what is queued
— alongside period figures for volume, cost, latency, error rate, and how many agent versions were
deployed.

**Insights** takes the failures and does the grouping for you. Failing runs are categorized from
structural proof — the run's status, the shape of its span tree, the agent's presence — never by
guessing at error text, and identical failures collapse into one ranked issue with its verbatim
reason and an agent-produced recommendation.

## Quality

Quality is graded, not observed. **Evaluations** puts LLM judges on a sampled share of runs and
records a score per rubric with the reasoning that produced it — so a low number comes with the
criteria that were checked and what moved it off full marks.

**Model Evaluation** answers the comparative question. Deploy a candidate beside production, let both
run every real request, and have a blinded judge say which output was better — which is far more
sensitive to a small real difference than diffing two absolute scores.

**Continuous Improvement** closes the loop. Accumulated verdicts become a named weakness, the
weakness becomes a concrete proposed diff, and the diff is settled as an experiment against runs that
actually happened, on quality, cost, and time together.

## Cost

**Agent spend attribution** builds every figure from what each run reported, and keeps the derivation
visible: cost is **reported** by the worker, **estimated** from model rates and token counts, or
**unattributed**. Spend pivots by label, agent, model, provider, MCP server, or tool, and budgets cap
what an agent may spend per window — with the option to stop it when the cap is reached.

## Portability

Everything above lives in KAOP. Two surfaces make it useful outside it.

**Observability & OTel export** emits agent activity as standard OpenTelemetry traces, logs, and
metrics to your own backend, so an agent's tool call sits in the same trace as the service it
touched. **Knowledge graph** is the estate KAOP has discovered by operating it — the resources, and
how incidents, cost findings, and agents attach to them.

## The order to read them in

<Steps>
  <Step title="Is the fleet up?">
    Fleet health's live cards. A capacity or presence problem makes every other reading unreliable.
  </Step>

  <Step title="What is failing, and is it new?">
    Insights. Grouped, ranked, and already categorized — with the run evidence one click away.
  </Step>

  <Step title="Of what succeeded, what was any good?">
    Evaluations. This is the reading nothing else substitutes for.
  </Step>

  <Step title="What did all of it cost?">
    Agent spend. Read cost per successful run before total spend — volume flatters a total.
  </Step>

  <Step title="Then change something, and prove it">
    Continuous Improvement for a proposal against history, Model Evaluation for a candidate against
    live traffic. Both settle before anything ships.
  </Step>
</Steps>

## The pages

<CardGroup cols={2}>
  <Card title="Fleet health" icon="heart-pulse" href="/manage-your-agents/optimize/fleet-health">
    Presence, capacity, backlog, reliability, and version churn across the whole fleet.
  </Card>

  <Card title="Evaluations" icon="gauge" href="/manage-your-agents/optimize/evaluations">
    LLM judges grading runs against explicit rubrics, with the reasoning behind every score.
  </Card>

  <Card title="Model Evaluation" icon="scale-balanced" href="/manage-your-agents/optimize/model-evaluation">
    A candidate beside production on real traffic, settled by a blinded judge.
  </Card>

  <Card title="Continuous Improvement" icon="arrows-spin" href="/manage-your-agents/optimize/continuous-improvement">
    Verdicts to a proposed change to a settled experiment to a human decision.
  </Card>

  <Card title="Agent spend attribution" icon="coins" href="/manage-your-agents/optimize/agent-spend-attribution">
    What the fleet costs per run, agent, and model — and budgets that cap it.
  </Card>

  <Card title="Knowledge graph" icon="diagram-project" href="/manage-your-agents/optimize/knowledge-graph">
    The estate your agents have discovered, and how incidents and findings attach to it.
  </Card>

  <Card title="Observability & OTel export" icon="telescope" href="/manage-your-agents/optimize/observability-otel-export">
    Agent traces, logs, and metrics in your own OpenTelemetry backend.
  </Card>
</CardGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Runs & evidence" href="/manage-your-agents/run/runs-evidence">
    The record every reading on these pages is computed from.
  </Card>

  <Card title="Build — how it works" href="/manage-your-agents/build/how-it-works">
    Where a fix lands once you know what to change.
  </Card>

  <Card title="Troubleshooting" href="/reference/troubleshooting">
    The fixes for the failure categories Insights reports.
  </Card>

  <Card title="Limits & quotas" href="/reference/limits-quotas">
    The caps that shape what a fleet can do.
  </Card>
</CardGroup>


## Related topics

- [How it works](/manage-your-agents/build/how-it-works.md)
- [How Run works](/manage-your-agents/run/how-it-works.md)
- [Architecture](/get-started/architecture.md)
- [Golden Scenarios](/manage-your-agents/optimize/golden-scenarios.md)
