Frequently Asked Questions
Everything you need to know about OpsViz. Can't find your answer? Contact support.
Getting Started
Do I need to install an SDK or modify my AI provider account?
No. OpsViz uses webhook URLs — your agent just sends a POST request. There's nothing to install, no API keys to share, and no provider access needed.
How long does it take to get set up?
Under 5 minutes. Create an account, add an agent (you get a webhook URL), paste the URL into your platform, and your first event will appear on the dashboard within seconds.
What AI platforms are supported?
Any platform that can make HTTP requests. We have guides for n8n, Zapier, Make, CrewAI, LangChain, OpenAI Assistants, Claude API, and custom webhooks. If your platform can POST JSON, it works.
Webhooks & Events
What is the only required field in the webhook payload?
"event_type" — everything else is optional. The most useful payload includes model, tokens_in, tokens_out, and status, but you can start with just event_type: "task.completed".
How are costs calculated if I don't send cost_usd?
If you send model + tokens_in + tokens_out, OpsViz looks up the model in our pricing database (35+ models across 8 providers) and calculates cost automatically. If the model isn't recognised, the event is stored but flagged as "uncosted".
Is the webhook URL secret?
Yes. The URL contains a random secret — treat it like a password. If compromised, you can regenerate it from the agent's settings page. The old URL stops working immediately.
What happens if my webhook call fails?
OpsViz returns appropriate HTTP status codes. We recommend implementing fire-and-forget with a timeout (3-5 seconds) so a monitoring failure never blocks your agent. See our platform guides for examples.
Plans & Limits
What counts as an "event"?
Each POST to the ingest endpoint counts as one event. A batch POST (/batch) counts one event per item in the array.
What happens to my data when I'm on the Free plan?
The Free plan shows 7 days of history in the dashboard. OpsViz retains your data for 30 days server-side — upgrade within 30 days to access older data.
Can I have multiple agents on the Free plan?
No, Free is limited to 1 agent. Starter allows 5, Pro allows 20, and Business has no limit.
Dashboard & Alerts
Why does my Free dashboard not update automatically?
Real-time updates require Supabase Realtime, which is a paid feature of OpsViz. Free users get the same data, just with manual refresh. Upgrade to Starter for real-time.
How do budget alerts work?
You set a budget_limit on each agent. OpsViz checks every 15 minutes and fires an alert when spend crosses your configured thresholds (60%/80%/100% depending on plan). Alerts won't fire more than once per 24 hours per rule.
Can I get Slack alerts?
Slack alerts are available on Pro and Business plans. Set up a Slack incoming webhook and configure it in your alert rules.