DevOps
Use flowbot devops for capability devops.
CLI root is devops — do not invent flowbot devops unless cli.md lists it as an alias.
Prefer the workflows below; load references/cli.md only when you need a flag or subcommand not covered here.
CLI limits: There is no flowbot devops health; use flowbot devops status for aggregate readiness, then backend-specific health/metrics commands.
JSON fields: Prefer -o json. Start with devops status to see which backends are configured.
Setup
- Ensure CLI auth:
flowbot login - Set server via
FLOWBOT_SERVER_URLor--server-url; optional--profile,--debug/-d - Prefer
-o jsonwhen parsing results programmatically - Destructive commands often need
-y/--yesin non-interactive sessions — check cli.md - Token scopes:
service:devops:read
Workflows
Check which backends are configured
When a user asks what devops tools are available:
flowbot devops status- Only call subcommands for backends reported as configured.
Inspect monitoring and routing
When a user wants a quick infrastructure snapshot:
flowbot devops beszel systemsflowbot devops uptimekuma healthflowbot devops traefik routersflowbot devops grafana healthflowbot devops wakapi projectsflowbot devops dozzle healthflowbot devops netalertx totals
Query observability backends via Grafana
When a user wants metrics, logs, traces, or profiles:
flowbot devops grafana datasourcesflowbot devops grafana query --backend prometheus --expr 'up'- Use backend alloy|loki|tempo|pyroscope with the matching expression language; prefer -o json for parsing.
Troubleshooting
| Error | Fix |
|---|---|
| not logged in | flowbot login |
| server URL is required | set FLOWBOT_SERVER_URL or pass --server-url |
| permission denied / 403 | token missing service scopes (service:devops:read) |
| hung waiting for confirm | pass -y when the command supports it (see cli.md) |
| empty results | provider not configured, wrong id/name, or empty dataset |
| unknown command | use flowbot devops, not the capability id as the CLI verb |