Contratos de eventos estables
El agente es guiado hacia eventos con nombre, campos snake_case delimitados, unidades explícitas e identificadores que siguen siendo útiles en SQL.
Pon la habilidad a trabajar
Añade eventos a un flujo de trabajo del agente
Comience con una clave API lista y un mensaje de agente, ejecute un flujo de trabajo representativo y verifique el evento resultante antes de crear un panel.
Qué cubre la habilidad
Instrucciones que terminan en datos inspeccionables
No incluyas datos privados
Las indicaciones sin procesar, las completaciones, las credenciales, los encabezados de autorización y las cargas útiles privadas permanecen fuera de la ruta de análisis de forma predeterminada.
Comprueba que los eventos llegan
La instrumentación no finaliza hasta que llegan los eventos representativos y una consulta o panel demuestra que el flujo de trabajo es visible.
Ejemplos de contenedor Telemetry
Darle al agente un límite de ingestión pequeño y revisable.
Usa la clave API de una configuración de servidor de confianza y verifica un evento real con SQL. Puedes usar claves anónimas para estos pasos. Vincula el espacio de trabajo a tu cuenta antes de crear paneles. Conserva la cabecera User-Agent de Python para que las solicitudes lleguen a la API.
mecanografiado
Envoltorio de telemetría TypeScript
javascript
type TelemetryEvent = Record<string, unknown>;
export async function emitTelemetry(
apiKey: string,
table: string,
data: TelemetryEvent,
) {
const response = await fetch("https://api.telemetry.sh/log", {
method: "POST",
headers: {
Authorization: apiKey,
"Content-Type": "application/json",
},
body: JSON.stringify({ table, data }),
signal: AbortSignal.timeout(5_000),
});
if (!response.ok) {
throw new Error(`Telemetry ingestion failed: ${response.status}`);
}
}pitón
Envoltorio de telemetría Python
python
import json
from urllib.request import Request, urlopen
def emit_telemetry(api_key: str, table: str, data: dict) -> int:
request = Request(
"https://api.telemetry.sh/log",
data=json.dumps({"table": table, "data": data}).encode(),
headers={
"Authorization": api_key,
"Content-Type": "application/json",
"User-Agent": "telemetry-agent/1.0",
},
method="POST",
)
with urlopen(request, timeout=5) as response:
return response.statusEmpieza aquí
Pegue un resumen acotado
Reemplace el marcador de posición con una clave API del lado del servidor y luego solicite al agente que inspeccione el repositorio antes de elegir los límites del evento.
aviso del agente
Aviso de observabilidad del agente de IA
text
Instrument this project with structured logs using /skill.md. Use this Telemetry API key en server-side code only: YOUR_API_KEY Anonymous keys support logging and synchronous SQL without signup. Claim the existing workspace at https://telemetry.sh/register with the same key before creating dashboards or alerts. If it is unclaimed, query the event to verify delivery and report which features need signup. Please: 1. Find the most important user-facing flows, background jobs, and AI/tooling workflows. 2. Add structured logging with snake_case table and field names. 3. Capture the key signals for each workflow, including status, latency, identifiers, and error context when relevant. 4. Run one real user-facing or operational flow through the instrumented application and verify its event appears in Telemetry. Do not use telemetry_quickstart for this milestone. 5. Run a read-only query over that real event, then create a high-level dashboard with charts and tables that summarize the most important signals in this project. 6. Tell me what you instrumented, which real flow you verified, which tables you created, and which dashboard views I should review first. Keep event payloads small and focused. Do not log credentials, raw request bodies, prompts, completions, tool arguments, or customer content. Keep telemetry delivery best-effort with bounded timeouts so a telemetry failure does not fail the application action. Make dashboard labels and charts easy to scan.Revisar límite
Mantenga a un humano en control del contrato
La habilidad ayuda a un agente a encontrar límites útiles en el flujo de trabajo, pero su equipo aún posee el significado del evento, los campos permitidos, la política de retención y los umbrales operativos.
- Revise cada tabla y campo nuevos antes de la implementación.
- Utilice identificadores acotados en lugar de cargas útiles privadas.
- Verificar el éxito, el fracaso y los resultados terminales.
Continuar el flujo de trabajo
Referencia SQL
El dialecto SQL, las expresiones, los tipos y las funciones compatibles con el motor de consultas de Telemetry.
abrir guiaPlantilla de panel de telemetría de agente de IA
Comience con un esquema de eventos limitado y un panel revisable para ejecuciones, herramientas, latencia, costos, fallas y resultados.
abrir guiaMonitoreo de agentes de IA
Elija límites útiles de ejecución, herramienta, modelo, costo, falla y resultado.
abrir guiaPaquete de avisos para agentes
Copie resúmenes centrados en análisis de productos, costos de OpenAI, API, ingresos y trabajos.
abrir guiaGuía de registro estructurado
Revise el diseño del evento, los límites de privacidad, el comportamiento de entrega y la verificación.
abrir guiaObservabilidad Claude Code
Aplique el contrato de evento revisado y el bucle de verificación de un pase de implementación Claude Code.
abrir guiaConfiguración de telemetría Cursor
Utilice un flujo de trabajo Cursor enfocado para activación, retención e instrumentación de panel inspeccionable.
abrir guiaAviso de instrumentación Codex
Proporcione a Codex un informe delimitado sobre la telemetría del producto, la confiabilidad y los resultados con verificación.
abrir guiaGuía de seguimiento de costos OpenAI
Conecte eventos de modelo, token, latencia, reintento y resultados aceptados a un panel de costos SQL revisable.
abrir guiaAñade eventos y comprueba los resultados
Comience gratis con un espacio de trabajo aprovisionado, una clave API, un mensaje para el agente y un panel de inicio. Conecte un flujo de trabajo real, verifique el evento y guarde la primera consulta útil.