Prefect

​

Prerequisites

• Prefect Cloud account or self-hosted Prefect Server
• API key (Prefect Cloud) or accessible API URL (self-hosted)

​

Setup

​

Option 1: Interactive CLI

healops integrations setup

​

Option 2: Persistent store

{
  "version": 1,
  "integrations": [
    {
      "id": "prefect-prod",
      "service": "prefect",
      "status": "active",
      "credentials": {
        "api_url": "https://api.prefect.cloud/api",
        "api_key": "your-prefect-api-key",
        "account_id": "your-account-id",
        "workspace_id": "your-workspace-id"
      }
    }
  ]
}

​

Prefect Cloud setup

1. In Prefect Cloud, go to your profile icon → API Keys
2. Click Create API Key
3. Copy the key, account ID, and workspace ID from the URL: https://app.prefect.cloud/account/<account-id>/workspace/<workspace-id>/

​

Self-hosted Prefect Server

{
  "api_url": "http://prefect-server:4200/api",
  "api_key": ""
}

​

Investigation tools

• Flow runs — lists recent flow runs filtered by state (FAILED, CRASHED, etc.)
• Flow run logs — retrieves log output for a specific flow run
• Workers — checks worker health and heartbeat status across work pools

​

Troubleshooting

​

Security best practices

• Use a service account API key rather than a personal key.
• For self-hosted, restrict network access to the Prefect API to trusted IPs.
• Store credentials in ~/.config/healops/integrations.json, not in source code.