OpenapiO11y
Reports whether the integration's logs and metrics have been received over the…
Reports whether the integration's logs and metrics have been received over the lookback window, so the console can show a live connection state.
GET /v1/o11y/integrations/{integrationId}/connection_status
| Address | https://api.hanzo.ai/v1/o11y/integrations/{integrationId}/connection_status |
| Method | GET |
| Operation | GetIntegrationConnectionStatus |
| Auth | Authorization: Bearer $HANZO_API_KEY |
Reports whether the integration's logs and metrics have been received over the lookback window, so the console can show a live connection state. An integration that is not installed answers with an empty status rather than an error. Viewer gate.
Request
2 fields.
| Field | In | Type | Required | Description |
|---|---|---|---|---|
integrationId | path | string | yes | |
lookback_seconds | query | integer | — | LookbackSeconds is how far back to look for received telemetry, in seconds. |
Response
| Status | Body | Meaning |
|---|---|---|
200 | o11y.O11yConnectionStatusOut | ok |
200 body — 8 fields.
| Field | In | Type | Always | Description |
|---|---|---|---|---|
data | body | o11y.IntegrationConnectionStatus | — | |
data.logs | body | o11y.SignalConnectionStatus | — | |
data.logs.last_received_from | body | string | — | resource identifier |
data.logs.last_received_ts_ms | body | integer | — | epoch milliseconds |
data.metrics | body | o11y.SignalConnectionStatus | — | |
data.metrics.last_received_from | body | string | — | resource identifier |
data.metrics.last_received_ts_ms | body | integer | — | epoch milliseconds |
status | body | string | — | Status is "success". |
Failure carries the platform error shape — see Errors.
Examples
hanzo o11y integrations connection_status <integrationId>import { Configuration, O11yApi } from 'hanzoai';
const api = new O11yApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getIntegrationConnectionStatus({ integrationId: 'integrationId' });from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import O11yApi
client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = O11yApi(client).get_integration_connection_status(integration_id='integrationId')cfg := cloud.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := cloud.NewAPIClient(cfg)
resp, _, err := client.O11yAPI.GetIntegrationConnectionStatus(context.Background()).Execute()
if err != nil {
return err
}use hanzo_cloud::apis::{configuration::Configuration, o11y_api};
let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();
let result = o11y_api::get_integration_connection_status(&cfg, Default::default()).await?;import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.O11yApi;
ApiClient client = new ApiClient();
client.setRequestInterceptor(b -> b.header("Authorization", "Bearer " + System.getenv("HANZO_API_KEY")));
var result = new O11yApi(client).getIntegrationConnectionStatus();curl https://api.hanzo.ai/v1/o11y/integrations/<integrationId>/connection_status \
-H "Authorization: Bearer $HANZO_API_KEY"Tool o11y, op GetIntegrationConnectionStatus — POST the JSON-RPC envelope to https://api.hanzo.ai/v1/mcp.
curl -X POST https://api.hanzo.ai/v1/mcp \
-H "Authorization: Bearer $HANZO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "o11y",
"arguments": {
"op": "GetIntegrationConnectionStatus",
"input": {
"integrationId": "<integrationId>"
}
}
}
}'How is this guide?