First Discovery Run

Create a Scope

A scope defines what to discover. It ties a plugin to credentials and configuration. Create one via the API:

curl -X POST http://localhost:8080/api/v1/discovery/scopes \
  -H "Content-Type: application/json" \
  -d '{
    "name": "prod-kubernetes",
    "plugin": "kubernetes",
    "config": {
      "kubeconfig": "",
      "contexts": []
    },
    "schedule": "0 */6 * * *"
  }'

This creates a scope that discovers all resources in the current Kubernetes context every 6 hours.

Trigger a Run

curl -X POST http://localhost:8080/api/v1/discovery/run \
  -H "Content-Type: application/json" \
  -d '{"scope_id": "prod-kubernetes"}'

The run starts immediately. The API returns a run ID you can poll for status:

curl http://localhost:8080/api/v1/discovery/runs/{run_id}

Inspect the Results

Once the run completes, explore what was discovered:

Service Catalog

curl http://localhost:8080/api/v1/services/

Cost Intelligence

curl http://localhost:8080/api/v1/cost/intelligence

Compliance Report

curl http://localhost:8080/api/v1/compliance

Cypher Query

curl -X POST http://localhost:8080/api/v1/graph/query \
  -H "Content-Type: application/json" \
  -d '{"query": "MATCH (n) RETURN n.type, count(n) GROUP BY n.type"}'

Next Steps

• Understand the resource model
• Query the knowledge graph with Cypher
• Configure advanced Kubernetes discovery
• Set up cloud provider credentials