Read-only production feedback endpoints (v0.40.7) for captured service log output, action performance metrics, compact operational summaries, and an agent-ready debugging prompt. Data is retained locally in PouchDB with redaction-safe storage.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/cernion-de:cernion-de-observability-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Cernion Energy Tools Observability API
version: 0.99.22
description: 'MicroService Agent System for Energy Markets - REST API with AI integration.
CERNION_TOKEN: request at https://cernion.de/ or by email: dev@stromdao.com.
For the public instance at https://api.cernion.de/, create your token at https://cernion.de/cet-token/.'
servers:
- url: https://api.cernion.de
description: API Server
tags:
- name: Observability
description: Read-only production feedback endpoints (v0.40.7) for captured service log output, action performance metrics, compact operational summaries, and an agent-ready debugging prompt. Data is retained locally in PouchDB with redaction-safe storage.
paths:
/api/observability/logs:
get:
summary: Retrieve captured broker and service log output
tags:
- Observability
operationId: observability_logs
parameters:
- name: level
in: query
schema:
type: string
enum:
- fatal
- error
- warn
- info
- debug
- trace
example: error
- name: service
in: query
schema:
type: string
example: finance-agent
- name: action
in: query
schema:
type: string
example: finance-agent.analyze
- name: contains
in: query
schema:
type: string
example: timeout
- name: limit
in: query
schema:
type: integer
default: 50
minimum: 1
maximum: 200
- name: sinceMinutes
in: query
schema:
type: integer
default: 60
minimum: 1
- name: since
in: query
schema:
type: string
format: date-time
example: '2026-05-04T08:00:00.000Z'
- name: until
in: query
schema:
type: string
format: date-time
example: '2026-05-04T12:00:00.000Z'
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Captured log messages
content:
application/json:
schema:
type: object
properties:
count:
type: integer
example: 12
generatedAt:
type: string
format: date-time
logs:
type: array
items:
type: object
properties:
timestamp:
type: string
format: date-time
level:
type: string
example: error
service:
type: string
example: finance-agent
action:
type:
- string
- 'null'
example: finance-agent.analyze
source:
type: string
example: service
nodeID:
type:
- string
- 'null'
requestOrigin:
type:
- string
- 'null'
example: gateway
errorType:
type:
- string
- 'null'
example: VALIDATION_ERROR
message:
type: string
description: Returns recently captured logger output from the Moleculer broker and loaded services. Messages are persisted locally in PouchDB with token and PII redaction for production-safe debugging.
/api/observability/metrics:
get:
summary: Retrieve aggregated action performance metrics
tags:
- Observability
operationId: observability_metrics
parameters:
- name: service
in: query
schema:
type: string
example: demo-ops
- name: action
in: query
schema:
type: string
example: demo-ops.success
- name: status
in: query
schema:
type: string
enum:
- success
- error
example: success
- name: limit
in: query
schema:
type: integer
default: 50
minimum: 1
maximum: 200
- name: sinceMinutes
in: query
schema:
type: integer
default: 1440
minimum: 1
- name: since
in: query
schema:
type: string
format: date-time
example: '2026-05-03T12:00:00.000Z'
- name: until
in: query
schema:
type: string
format: date-time
example: '2026-05-04T12:00:00.000Z'
- name: slowActionThresholdMs
in: query
schema:
type: integer
default: 1000
minimum: 1
- name: includeRaw
in: query
schema:
type: boolean
default: false
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Aggregated action metrics
content:
application/json:
schema:
type: object
properties:
count:
type: integer
generatedAt:
type: string
format: date-time
summary:
type: object
actions:
type: array
items:
type: object
recent:
type: array
items:
type: object
description: Returns per-action performance statistics captured at broker level for local and gateway-triggered Moleculer actions. Metrics include durations, success/error counts, and slow-action detection.
/api/observability/summary:
get:
summary: Retrieve an operational overview for recent logs and performance
tags:
- Observability
operationId: observability_summary
parameters:
- name: limit
in: query
schema:
type: integer
default: 50
minimum: 1
maximum: 50
- name: sinceMinutes
in: query
schema:
type: integer
default: 60
minimum: 1
- name: slowActionThresholdMs
in: query
schema:
type: integer
default: 1000
minimum: 1
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Operational overview
content:
application/json:
schema:
type: object
properties:
generatedAt:
type: string
format: date-time
window:
type: object
retention:
type: object
logs:
type: object
metrics:
type: object
description: Returns a compact production-feedback overview containing recent log volume, latest errors, action throughput, and slowest actions over a configurable time window.
/api/observability/agent-prompt:
get:
summary: Generate an agent-ready debugging prompt from recent production feedback
tags:
- Observability
operationId: observability_agentPrompt
parameters:
- name: sinceMinutes
in: query
schema:
type: integer
default: 60
minimum: 1
example: 120
- name: slowActionThresholdMs
in: query
schema:
type: integer
default: 1000
minimum: 1
example: 1500
- name: limit
in: query
schema:
type: integer
default: 5
minimum: 1
maximum: 20
example: 5
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Agent prompt template with structured production context
content:
application/json:
schema:
type: object
properties:
generatedAt:
type: string
format: date-time
window:
type: object
prompt:
type: string
context:
type: object
description: 'Builds a compact prompt for agentic troubleshooting from observability summary signals: error volume, latency hotspots, recent redacted errors, and slowest actions in the selected time window.'
components:
parameters:
TokenQuery:
name: token
in: query
required: false
schema:
type: string
description: Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: 'Optional Cernion MCP token. If not provided, falls back to CERNION_TOKEN from environment. Request token at https://cernion.de/ or by email: dev@stromdao.com.'