Logs, Events & Replicas — API Reference

curl -sS "https://api.dev.dodil.io/v1/ignite/app/acme-corp/my-data-processor/logs?limit=200" \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc GetAppLogs(GetAppLogsRequest) returns (GetAppLogsResponse);
 
message GetAppLogsRequest {
  string organization_name = 1;
  string app_name          = 2;
  int64 since_ms = 3;                 // 0 = default look-back (5 minutes)
  int64 until_ms = 4;                 // 0 = now
  int64 limit    = 5;                 // default 1000, capped server-side
  string execution_id_filter = 6;     // narrow to one invocation (app must echo X-Ignite-Execution-Id)
  string replica_id = 7;              // pin to one pod; empty = aggregate across replicas
  LogStream stream  = 8;              // STDOUT / STDERR; default = both
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "organization_name": "acme-corp",
    "app_name": "my-data-processor",
    "limit": "200"
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/GetAppLogs

{
  "lines": [
    {
      "timestampMs": "1716894000123",
      "replicaId": "my-data-processor-7c9d8-abcde",
      "stream": "LOG_STREAM_STDOUT",
      "line": "processed batch 42 in 18ms"
    }
  ],
  "truncated": false
}

message GetAppLogsResponse {
  repeated LogLine lines = 1;
  bool truncated = 2;                 // true = hit limit before the range ended; advance since_ms past the last line
}
 
message LogLine {
  int64 timestamp_ms = 1;             // pod-side wall-clock when emitted
  string replica_id  = 2;             // K8s pod name
  LogStream stream   = 3;
  string line        = 4;             // line contents (no trailing newline)
}

curl -sS -N "https://api.dev.dodil.io/v1/ignite/app/acme-corp/my-data-processor/logs/stream" \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc StreamAppLogs(StreamAppLogsRequest) returns (stream LogLine);
 
message StreamAppLogsRequest {
  string organization_name = 1;
  string app_name          = 2;
  string execution_id_filter = 3;
  string replica_id          = 4;     // empty = merge across replicas
  LogStream stream           = 5;     // default = both
  bool from_start            = 6;     // false = tail from now; true = replay history then tail
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "organization_name": "acme-corp",
    "app_name": "my-data-processor"
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/StreamAppLogs

curl -sS "https://api.dev.dodil.io/v1/ignite/app/acme-corp/my-data-processor/events?severity=Warning" \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc GetAppEvents(GetAppEventsRequest) returns (GetAppEventsResponse);
 
message GetAppEventsRequest {
  string organization_name = 1;
  string app_name          = 2;
  int64 since_ms = 3;                 // 0 = last hour
  int64 until_ms = 4;                 // 0 = now
  int64 limit    = 5;                 // default 200
  string replica_id = 6;              // empty = all replicas
  string severity   = 7;              // "Normal" / "Warning"; empty = both
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "organization_name": "acme-corp",
    "app_name": "my-data-processor",
    "severity": "Warning"
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/GetAppEvents

{
  "events": [
    {
      "timestampMs": "1716894001000",
      "kind": "APP_EVENT_KIND_OOM_KILLED",
      "reason": "OOMKilling",
      "message": "Memory cgroup out of memory: Killed process 1",
      "replicaId": "my-data-processor-7c9d8-abcde",
      "count": 1,
      "severity": "Warning"
    }
  ],
  "truncated": false
}

message GetAppEventsResponse {
  repeated AppEvent events = 1;
  bool truncated = 2;
}
 
message AppEvent {
  int64 timestamp_ms = 1;
  AppEventKind kind  = 2;             // IMAGE_PULL / LIFECYCLE / CRASH / OOM_KILLED / PROBE_FAILURE / SCHEDULING / SCALING / OTHER
  string reason      = 3;             // raw K8s event.reason
  string message     = 4;             // raw K8s event.message
  string replica_id  = 5;             // pod name (empty for cluster-scoped events)
  int32 count        = 6;             // K8s repeat multiplier
  string severity    = 7;             // "Normal" or "Warning"
}

curl -sS -N "https://api.dev.dodil.io/v1/ignite/app/acme-corp/my-data-processor/events/stream" \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc StreamAppEvents(StreamAppEventsRequest) returns (stream AppEvent);
 
message StreamAppEventsRequest {
  string organization_name = 1;
  string app_name          = 2;
  string replica_id        = 3;       // empty = all replicas
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "organization_name": "acme-corp",
    "app_name": "my-data-processor"
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/StreamAppEvents

curl -sS "https://api.dev.dodil.io/v1/ignite/app/acme-corp/my-data-processor/replicas" \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc ListAppReplicas(ListAppReplicasRequest) returns (ListAppReplicasResponse);
 
message ListAppReplicasRequest {
  string organization_name = 1;
  string app_name          = 2;
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "organization_name": "acme-corp",
    "app_name": "my-data-processor"
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/ListAppReplicas

{
  "replicas": [
    {
      "replicaId": "my-data-processor-7c9d8-abcde",
      "clusterId": "worker-eu-1",
      "nodeName": "ip-10-0-3-17",
      "status": "STATUS_RUNNING",
      "ready": true,
      "restartCount": 0,
      "startedMs": "1716893900000",
      "conditionsSummary": "PodScheduled=True, Initialized=True, ContainersReady=True",
      "cpuMillicoresUsed": "120",
      "memoryMbUsed": "210"
    }
  ]
}

message ListAppReplicasResponse {
  repeated AppReplica replicas = 1;
}
 
message AppReplica {
  string replica_id     = 1;          // K8s pod name (stable per restart)
  string cluster_id     = 2;          // worker cluster the pod runs on
  string node_name      = 3;          // which node hosts the pod (optional)
  Status status         = 4;          // PENDING / RUNNING / SUCCEEDED / FAILED / UNKNOWN
  bool ready            = 5;          // readiness-probe state (true → traffic flowing)
  int32 restart_count   = 6;
  int64 started_ms      = 7;
  string waiting_reason     = 8;      // e.g. "ImagePullBackOff" / "CrashLoopBackOff"; empty when running normally
  string waiting_message    = 9;
  string conditions_summary = 10;     // summary of the pod Conditions block
  int64 cpu_millicores_used = 11;     // live, from metrics-server; 0 when unavailable
  int64 memory_mb_used      = 12;
}

curl -sS "https://api.dev.dodil.io/v1/ignite/app/acme-corp/my-data-processor/builds/bld_01HZX9/log" \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc GetBuildLog(GetBuildLogRequest) returns (GetBuildLogResponse);
 
message GetBuildLogRequest {
  string organization_name = 1;
  string app_name          = 2;
  string build_id          = 3;
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "organization_name": "acme-corp",
    "app_name": "my-data-processor",
    "build_id": "bld_01HZX9"
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/GetBuildLog

{
  "log": "U3RlcCAxLzg6IEZST00gcHl0aG9uOjMuMTItc2xpbQo=",
  "found": true
}

message GetBuildLogResponse {
  bytes log  = 1;                     // UTF-8 plain text; empty when found=false
  bool found = 2;                     // false = still running with nothing persisted yet, OR GC'd ("log expired")
}

curl -sS -N "https://api.dev.dodil.io/v1/ignite/compile/dpl_01HZX9/logs?fromStart=true" \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc StreamCompileLogs(StreamCompileLogsRequest) returns (stream CompileLogChunk);
 
message StreamCompileLogsRequest {
  string deploy_id = 1;
  bool from_start  = 2;               // true = replay from the start of the build, then tail
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "deploy_id": "dpl_01HZX9",
    "from_start": true
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/StreamCompileLogs