Ler original em português

← All content

dooopSoftware · Learning · 12 min

How to Instrument Telemetry in AI-Enabled Features

Telemetry in AI products should separate intent, execution, and outcome to measure value, risk, and next adjustments without storing everything.

Published on September 6, 2026

CORE THESIS

Too much telemetry becomes noise. Too little telemetry turns AI into a gamble that’s hard to compare.

Event design must separate task, execution, and outcome. Only then does usage become product evidence.

Telemetry for AI products begins with event and attribute design: what needs to be recorded to reconstruct the task, interpret the outcome, and decide the next investigation. In an intelligent feature, usage volume, latency, and technical errors show activity but rarely explain whether the AI helped, confused, required correction, or created risk.

This architecture separates three layers: user intent, AI execution, and observable evidence of outcome.

What telemetry needs to answer about the intelligent feature

When an intelligent feature is put into use, the product team usually asks simple questions: in which situations did it help, where did it hinder, which users needed to correct the response, and which cases should become improvements. The problem is that product instrumentation often starts either too technical or too generic.

Too technical when it only records model calls, response time, API errors, and availability. Too generic when it measures clicks, sessions, and usage volume without task context.

Telemetry for AI products needs to answer product questions, not just infrastructure questions. Some useful questions include:

  • What task was the user trying to complete when triggering the AI?
  • What context was available to the feature at that moment?
  • What did the AI execute: direct response, knowledge base search, tool call, suggestion, or summary?
  • Did the user accept, edit, retry, abandon, or revert the action?
  • Is the observed outcome consistent with task success or just feature usage?
  • In which segments does behavior change enough to warrant investigation?

This distinction matters because usage alone is not value. A feature can be triggered many times because it solves a real pain. It can also be triggered many times because it errs, requires retries, or became a mandatory step in a poorly designed flow.

dooop treats this type of decision as part of a broader responsible AI adoption strategy. At a prior level, the topic appears in how to create an AI strategy connected to business: before measuring, the organization needs to know which decision it wants to improve.

Three event blocks: intent, execution, and observed outcome

A good telemetry design for an intelligent feature starts with three blocks.

The first block is user intent. It records the attempted task, flow point, command type, selected context, and when relevant, the operational category of the case. It is not necessary to store everything in raw text to recognize intent. Often, a task taxonomy already allows sufficient analysis.

The second block is AI execution. This includes information such as feature version, model used when relevant for internal analysis, tool triggered, consulted context source, attempt, response state, execution time, and fallback. In this article, fallback is the alternative path used when the AI does not respond, lacks sufficient confidence, or needs to return control to the user.

The third block is the observed outcome. This is the point that separates useful telemetry from decorative telemetry. The outcome can be suggestion acceptance, manual editing, retry, abandonment, reversal, escalation, user rating, or completion of a verifiable step in the system.

Anthropic distinguishes an agent’s execution trajectory from the effective result in the environment. A message stating the task is finished is not enough to prove the outcome. The same logic applies to AI products: a response presented by the feature is not proof the user’s task was completed.

This distinction avoids a common trap. If the dashboard shows the AI responded, the team might conclude the flow worked. But if the user edited almost everything, requested another response, contacted support, or undid the action, the product signal is different.

Minimum events, retention, and risk of excessive collection

Instrumenting an intelligent feature requires choosing events that answer recurring questions from product, support, quality, and risk teams.

Generally useful events in an intelligent feature include:

  • Task start or entry into the flow where AI can be used.
  • Request sent to the AI.
  • Response presented to the user.
  • User action after the response.
  • Manual correction or relevant editing.
  • Retry.
  • Fallback to traditional flow or human intervention.
  • Technical error or unavailable response.
  • Observable closure, abandonment, or completion.

There are also data types that should be avoided by default unless there is clear justification and proper protection. Complete inputs with sensitive information, personal fields without analytical need, and extensive logs that no one knows how to interpret tend to increase risk without increasing learning.

A simple criterion helps: if the data does not change a product, support, quality, or risk decision, it needs justification before inclusion.

This does not resolve all privacy, security, or governance discussions but changes the starting point. Instead of asking "what can we collect?", the team asks "which decision does this data enable?". In sensitive contexts, categories, masking, sampling, and limited retention may be better than storing raw content.

Context attributes to compare segments

Overall averages can hide important problems. Google SRE explains, in the monitoring context, that averages can conceal problematic behaviors and that different views serve different audiences. In product, the corresponding reading is that an intelligent feature may appear stable on average but fail in relevant contexts.

Context attributes help separate these situations. Some examples:

  • Task type.
  • Usage channel.
  • User operational profile, without exposing unnecessary identity.
  • Feature version.
  • Language.
  • Knowledge source used.
  • Presence of human intervention.
  • Exposure group in an experiment.
  • Flow state before AI was triggered.

These attributes alone do not prove causality. They enable comparison. If a summarization AI works one way on simple tickets and another on tickets with long history, the average should not decide for the team. Context slicing helps formulate the next question.

This care aligns with maturity decisions. In AI maturity, the issue is not having sophisticated technology but knowing if the organization can operate, evaluate, and adjust AI use with judgment.

Subsequent signals: success, failure, and uncertainty

The easiest signal to measure is not always the one closest to the task. Click, view, and generated response indicate exposure. They are not enough to infer quality.

More useful signals usually appear after the AI response:

  • The user kept the suggestion without relevant changes.
  • The user edited the suggestion before proceeding.
  • The user requested a new response.
  • The user copied the response to another flow.
  • The user undid the action.
  • The case was reopened.
  • The user contacted support.
  • A verifiable step was completed in the system.
  • The user rated the outcome, when that rating has sufficient context for analysis.

Imagine, fictitiously, an AI that suggests responses for customer service. "Response sent" is one signal. "Response edited before sending" is another. "Case reopened after response" is yet another. None alone closes the interpretation.

The sent response may indicate usefulness. It may also indicate the agent was in a hurry. Editing may indicate human improvement on a good base. It may also indicate the suggestion was inadequate. Reopening may relate to the response, problem complexity, or a customer expectation unavailable to the AI.

Good telemetry reduces dependence on memory, anecdotes, or the loudest opinion in the room.

Event quality before interpreting variations

Before changing the feature based on data, the team needs to review whether collection is interpretable. This step is less flashy than a dashboard but often where bad decisions are avoided.

Review questions:

  • Do events trigger at the correct flow moment?
  • Is there event duplication caused by reload, automatic retry, or interface change?
  • Are events missing in specific channels?
  • Do segments have sufficient volume for responsible interpretation?
  • Did the event definition change during the analyzed period?
  • Did a layout change increase clicks without changing utility?
  • Are spikes or drops compatible with exposure, availability, or operational change?

Microsoft, when addressing experimentation, recommends observing a broad set of metrics and segments during monitoring to identify regressions and avoid premature interpretations (Microsoft Research). In post-analysis, it also recommends verifying if metric changes align with test design and if data quality issues compromise interpretation before deciding on release (Microsoft Research).

Even outside formal experiments, the principle is useful. If instrumentation changed mid-period, an indicator variation may be a collection change, not behavior change.

For organizations building an adoption roadmap, this changes the conversation order. The next AI step should not be decided only by the list of desired features. It must consider whether the company can learn from use. This point also appears in the AI roadmap: prioritizing without measurement capacity creates a queue of hard-to-compare bets.

Fictional example: telemetry for an AI summarizing support tickets

Consider a fictional example: a company uses an intelligent feature to summarize support tickets before the agent writes the response. The hypothetical goal is to reduce reading effort without worsening case understanding. This effect would need to be measured, not assumed.

Useful instrumentation could record events such as:

  • Ticket opened.
  • Summary requested.
  • Summary displayed.
  • Summary edited or supplemented by the agent.
  • Response sent.
  • New query to full history.
  • Fallback to manual reading.
  • Agent feedback on the summary.
  • Ticket reopened.

Attributes could include ticket type, entry channel, feature version, consulted knowledge source, language, and presence of long history. Instead of storing the full ticket text in a broad analytical database, the team could use task categories, complexity markers, and edit indicators when sufficient to answer product questions.

With this telemetry, the team could investigate questions such as:

  • In which ticket types does the summary seem to reduce effort without causing rework?
  • Where does the agent always return to full history after seeing the summary?
  • Which editing patterns should become AI evaluation cases?
  • In which contexts does fallback to manual reading appear frequently enough to investigate?
  • Which data do not need to be stored because they do not change any decision?

Note the difference. The goal is not to prove the AI "works" by being used. The goal is to create enough traces to decide whether the feature should be kept as is, adjusted in certain contexts, limited to specific task types, or investigated with qualitative research.

Short instrumentation matrix for product questions

Before publishing or reviewing an intelligent feature, it is worth mapping each criterion in a short matrix.

Decision question

Is there an explicit question this data helps answer?

Good sign: the event helps decide to keep, change, investigate, limit, or remove a feature part.

Warning sign: the event exists only because it is easy to collect.

User task

Does the record identify which task was being attempted?

Good sign: there is task type, flow step, or operational context sufficient for analysis.

Warning sign: only click counts or model calls exist.

AI execution

Does the record differentiate request, response, attempt, tool, version, or context source used?

Good sign: it is possible to compare behaviors between versions or configurations.

Warning sign: all responses appear as a single generic category.

Observable outcome

Is there a verifiable signal after the AI response?

Good sign: acceptance, editing, retry, abandonment, reversal, escalation, or system completion.

Warning sign: the AI message stating completion is treated as proof of success.

Minimum segmentation

Can the analysis separate relevant task types, users, channels, or versions?

Good sign: the team can identify where the feature works well and where it degrades.

Warning sign: the overall average hides groups with very different behavior.

Privacy and necessity

Does each collected field have a defined analytical purpose?

Good sign: sensitive data are minimized, masked, or replaced by categories when possible.

Warning sign: the team stores full inputs by default without knowing how they will be used.

Data quality

Is there verification of duplication, absence, delay, and event definition changes?

Good sign: before deciding, the team knows if the data is interpretable.

Warning sign: a collection change is confused with a real behavior change.

Limits of telemetry for AI products

This guide addresses instrumentation of intelligent feature use, not final metric selection, full experiment design, or model training.

Telemetry does not replace qualitative research, support analysis, or specific quality assessments. It creates traces to formulate better questions and reduce decisions based only on perception.

It is also necessary to resist indiscriminate capture. Not all useful data needs to be collected in raw form. In many cases, responsible learning means reducing granularity, categorizing, masking, limiting retention, or combining telemetry with sampled human review.

The minimal architecture becomes explicit when each intelligent feature has events, attributes, and outcome signals capable of answering: what the user tried to do, what the AI executed, and what evidence indicates success, correction, abandonment, or risk. If this separation is unclear, the dashboard may look rich yet still not guide the next investigation.

If you want to discuss this decision in your company’s context, talk to dooop.

Further reading

Sources

NEXT DECISION

Discussing application in the company

Conversation about the software company context

Content by dooop. Registration allows linking this topic to the reader’s journey and tracking interest in the subject.

Conversation about the software company context

We will use your details to deliver this content and contact you about related topics.