Skip to main content
OISP Sensor emits events conforming to the OISP v0.1 specification.

​
What is OISP?

Open Inference Standard Protocol (OISP) is the Open Interoperability Specification for AI activity observability. A universal schema for capturing AI interactions across every environment—browser, desktop, CLI, server—with support for 2,200+ models from every major provider. It provides:
  • Unified schema for AI events across providers
  • Interoperability between observability tools
  • Extensibility for custom event types

​
Specification Repository

​
Core Concepts

​
Events

An OISP event represents a single observable occurrence in an AI system:
  • AI model request/response
  • Agent tool invocation
  • Process execution
  • File operation
  • Network connection

​
Envelope

Every event has a common envelope with metadata: 
{
  "oisp_version": "0.1",
  "event_id": "unique-id",
  "event_type": "ai.request",
  "ts": "2024-12-23T10:30:00.000Z",
  "host": { ... },
  "process": { ... },
  "source": { ... },
  "confidence": { ... },
  "data": { ... }
}

​
Traces

Related events are grouped into traces:
  • Agent session
  • Request/response pairs
  • Tool call chains

​
Event Categories

​
ai.*

AI model interactions:
  • ai.request - Request to AI model
  • ai.response - Response from AI model
  • ai.streaming_chunk - Streaming response chunk
  • ai.embedding - Embedding request

​
agent.*

Agent-specific events:
  • agent.tool_call - Tool invocation
  • agent.tool_result - Tool result

​
process.*

Process lifecycle:
  • process.exec - Process started
  • process.exit - Process ended
  • process.fork - Process forked

​
file.*

File operations:
  • file.open - File opened
  • file.read - File read
  • file.write - File written
  • file.close - File closed

​
network.*

Network activity:
  • network.connect - Outgoing connection
  • network.accept - Incoming connection
  • network.flow - Flow summary
  • network.dns - DNS query

​
Provider Detection

OISP defines provider identification via:
  1. Endpoint URL patterns
  2. Request headers
  3. Response headers
  4. Request/response body structure
See /semconv/providers/ in the spec for detection rules.

​
Semantic Conventions

OISP extends OpenTelemetry semantic conventions for AI:

​
AI Attributes

AttributeTypeDescription
ai.providerstringProvider name
ai.model.idstringModel identifier
ai.model.familystringModel family (gpt, claude, etc.)
ai.request_typestringcompletion, embedding, etc.
ai.tokens.promptintInput tokens
ai.tokens.completionintOutput tokens
ai.latency_msfloatResponse latency

​
Agent Attributes

AttributeTypeDescription
agent.tool.namestringTool name
agent.tool.typestringfunction, mcp, etc.
agent.mcp_serverstringMCP server name

​
Validation

Validate events against the schema: 
# Using ajv-cli
npx ajv validate -s oisp-spec/schema/v0.1/ai-request.json -d event.json

​
Contributing

The OISP specification is open for contributions:
  1. Fork https://github.com/oximyHQ/oisp-spec
  2. Propose changes via pull request
  3. Discuss in issues

​
Relationship to OpenTelemetry

OISP is designed to complement OpenTelemetry:
  • Uses OTel semantic convention patterns
  • Events can be exported as OTel logs/spans
  • Extends OTel for AI-specific concepts
OISP Sensor exports to OTLP natively.

​
Version History

VersionDateNotes
0.12024-12Initial release