package cloud

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc SearchLogs (SearchLogsRequest, SearchLogsResponse)

  cloud.proto:15

  Dozzle-initiated unary call: search log lines this instance has streamed to Cloud (gated by streamLogs opt-in). Cloud scopes the query server-side to the (user_id, api_key_id) derived from the authenticated connection; Dozzle does NOT pass any identity fields in the request.

  message SearchLogsRequest

  cloud.proto:247

  Cloud log search.

  • string query = 1

    Substring/word-filter query. Empty -> empty result. Whitespace-only is rejected client-side; server treats as empty.

  • int32 limit = 2

    Result cap. Default 20, server-capped at 50.

  • int64 before_ts_ns = 3

    Pagination cursor: return only hits with timestamp_ns < this value. 0 = newest. Reserved for future use.

  • string host_id = 4

    Optional filter — narrow to a specific Docker host inside the instance. Empty = all hosts under this instance.

  • string container_id = 5

    Optional filter — narrow to a specific container.

  message SearchLogsResponse

  cloud.proto:263

  • repeated SearchLogHit hits = 1

  • bool has_more = 2

  • int64 next_before_ts_ns = 3

    For pagination: pass back as before_ts_ns to fetch the next page.

• rpc ToolStream (stream ToolResponse, stream ToolRequest)

  cloud.proto:9

  Dozzle sends ToolResponse, cloud sends ToolRequest

  message ToolResponse

  cloud.proto:27

  • string request_id = 1

  • oneof type

    • ListToolsResponse list_tools = 2

    • CallToolResponse call_tool = 3

    • LogBatch log_batch = 4

      Unsolicited server-push: batched container log lines streamed from Dozzle to Cloud for ingestion into VictoriaLogs. request_id is empty for log batches — they are not replies to a ToolRequest.

  message ToolRequest

  cloud.proto:18

  • string request_id = 1

  • oneof type

    • ListToolsRequest list_tools = 2

    • CallToolRequest call_tool = 3

    • CancelStreamRequest cancel_stream = 4

Container action result

Used in: CallToolResponse

• bool success = 1

• string container_id = 2

• string action = 3

• string message = 4

Used in: ToolRequest

• string name = 1

• string arguments_json = 2

Used in: ToolResponse

• bool success = 1

• string error = 2

• bool stream = 9

• bool end_stream = 10

• oneof result

  • ListHostsResult list_hosts = 3

  • ListContainersResult list_containers = 4

  • ContainerStatsResult container_stats = 5

  • ActionResult action = 6

  • FetchLogsResult fetch_logs = 7

  • InspectContainerResult inspect_container = 8

  • DeployResult deploy = 11

  • NotificationResult notification = 12

Used in: ToolRequest

• string stream_request_id = 1

Container information

Used in: ListContainersResult

• string id = 1

• string name = 2

• string image = 3

• string command = 4

• string created = 5

• string started_at = 6

• string finished_at = 7

• string state = 8

• string health = 9

• string host_name = 10

• string host_id = 12

• string group = 11

Container stats

Used in: ContainerStatsResult

• string id = 1

• string name = 2

• string host = 3

• double cpu_percent = 4

• double memory_percent = 5

• double memory_usage = 6

• double max_cpu_5min = 7

• double max_memory_5min = 8

• string host_id = 9

• uint64 network_rx_total = 10

• uint64 network_tx_total = 11

• uint64 network_rx_5min = 12

• uint64 network_tx_5min = 13

Used in: CallToolResponse

• repeated ContainerStatEntry stats = 1

Deploy compose result

Used in: CallToolResponse

• bool success = 1

• string project = 2

• string message = 3

Used in: CallToolResponse

• string container_name = 1

• repeated LogEntry entries = 2

Host information

Used in: ListHostsResult

• string id = 1

• string name = 2

• int32 n_cpu = 3

• int64 mem_total = 4

• string docker_version = 5

• string agent_version = 6

• string type = 7

• bool available = 8

Container inspect result

Used in: CallToolResponse

• string id = 1

• string name = 2

• string image = 3

• string command = 4

• string created = 5

• string started_at = 6

• string finished_at = 7

• string state = 8

• string health = 9

• string host_name = 10

• string host_id = 19

• map<string, string> labels = 11

• uint64 memory_limit = 12

• double cpu_limit = 13

• repeated string ports = 15

• repeated string mounts = 16

• string restart_policy = 17

• string network_mode = 18

Used in: CallToolResponse

• repeated ContainerInfo containers = 1

Used in: CallToolResponse

• repeated HostInfo hosts = 1

Used in: ToolRequest

(message has no fields)

Used in: ToolResponse

• repeated ToolDefinition tools = 1

• string version = 2

Batch of log lines from one or more containers. Dozzle pushes these continuously while connected. Cloud routes them to VictoriaLogs scoped to the owning user (derived from the connection's auth).

Used in: ToolResponse

• repeated LogBatchEntry entries = 1

Used in: LogBatch

• string host_id = 1

• string container_id = 2

• string container_name = 3

• int64 timestamp_ns = 4

  unix nanoseconds

• string message = 5

• string stream = 6

  "stdout" or "stderr"

• string level = 7

  "info", "warn", "error", etc. (best-effort)

• uint32 log_id = 8

  Deterministic FNV-32a hash of the raw log line, the same id Dozzle stamps on LogEvent.Id. Cloud indexes this as a non-stream field so search results can produce a stable permanent link (/container/:id/time/:datetime?logId=...) that lands the user on exactly the matching line in the local log viewer.

Container logs

Used in: FetchLogsResult

• int64 timestamp = 1

• string message = 2

• string stream = 3

  "stdout" or "stderr"

• string level = 4

  "info", "warn", "error", etc.

Notification/alert tool result (list, create).

Used in: CallToolResponse

• bool success = 1

• string message = 2

Used in: SearchLogsResponse

• int64 timestamp_ns = 1

• string host_id = 2

• string container_id = 3

• string container_name = 4

• string message = 5

  Full log line as indexed.

• string stream = 6

• string level = 7

• uint32 log_id = 8

  FNV-32a hash of the raw log line — same id Dozzle assigns LogEvent.Id and exposes via "Copy permalink". Lets the search-result row deep-link straight to the matching line.

Used in: ListToolsResponse

• string name = 1

• string description = 2

• string parameters_json = 3

• ToolScope scope = 4

  scope tells the cloud router how to multiplex calls to this tool. Dozzle itself has no notion of "multiple instances"; this field lets the router decide whether to fan out (default), target a specific container/host inferred from the existing host_id/container_id params, or target the whole Dozzle instance (in which case the router injects an instance_id argument into the LLM-facing schema and strips it before forwarding).

• bool read_only = 5

  read_only = true means the tool has no side effects and is safe to fan out across every connected Dozzle instance when the scope's routing argument is missing (e.g. list_notifications without instance_id queries all instances and merges results). Mutating tools (create/delete/deploy/ restart/etc.) must leave this false — the router will require the scope argument and error if it's missing, so a write never fans out by mistake.

Used in: ToolDefinition

• TOOL_SCOPE_UNSPECIFIED = 0

  Default — treated as INSTANCE. Exists so forward-compat clients without a scope field don't misroute.

• TOOL_SCOPE_INSTANCE = 1

  Applies to the whole Dozzle instance (list_hosts, notifications, etc.). Requires instance_id in the args.

• TOOL_SCOPE_HOST = 2

  Targets a specific Docker host (deploy_compose, list_deploy_versions). Requires host_id in the args.

• TOOL_SCOPE_CONTAINER = 3

  Targets a specific container (logs, actions, inspect). Requires container_id in the args (host_id is typically also present for the Docker API call inside Dozzle but isn't used for routing).