OS Manuals

/usr/bin/placement

Dapr Placement control plane service

From dapr-placement-1.19 1.19.1-r2 (enterprise-packages), captured 2026-11-08 by running placement --help (exit 0). permalink

Usage of placement:
      --disseminate-coalesce-window duration   if >0, after a dissemination round completes, defer the next round by this window so additional host
                                               registers/disconnects arriving inside the window collapse into a single round.
                                               Keeps cold-start of dissemination responsive (the first event fires immediately) while reducing per-event
                                               drain+halt overhead during bulk scale events. Default 0 disables coalescing. Recommended 100-250ms for
                                               clusters with frequent rapid churn (eg. >50 replica scale-ups).
      --disseminate-timeout duration           sets the period of time in which a dissemination is considered failed if not completed.
                                               Any daprds which have not responded within this time will be considered non-responsive and kicked.
                                               Higher values will increase the grace period to complete dissemination in case of network issues,
                                               but reduce the chance of skipping daprds which are slow to respond. (default 8s)
      --enable-metrics                         Enable prometheus metric (default true)
      --healthz-listen-address string          The listening address for the healthz server
      --healthz-port int                       sets the HTTP port for the healthz server (default 8080)
      --id string                              Placement server ID (default "dapr-placement-0")
      --initial-cluster strings                raft cluster peers (default [dapr-placement-0=127.0.0.1:8201])
      --inmem-store-enabled                    Enable in-memory log and snapshot store unless --raft-logstore-path is set (default true)
      --keepalive-time duration                sets the interval at which the placement service sends keepalive pings to daprd
                                               on the gRPC stream to check if the connection is still alive.
                                               Lower values will lead to shorter actor rebalancing time in case of pod loss/restart,
                                               but higher network traffic during normal operation.
                                               Accepts values between 1 and 10 seconds (default 2s)
      --keepalive-timeout duration             sets the timeout period for daprd to respond to the placement service's keepalive pings
                                               before the placement service closes the connection.
                                               Lower values will lead to shorter actor rebalancing time in case of pod loss/restart,
                                               but higher network traffic during normal operation.
                                               Accepts values between 1 and 10 seconds (default 3s)
      --listen-address string                  The listening address for the placement service
      --log-as-json                            print log as JSON (default false)
      --log-file string                        Path to a file where logs will be written
      --log-file-compression string            Compression for rotated log files: "none" or "gzip" (default none). No effect without a file destination
      --log-file-max-age string                Maximum number of days to retain rotated log files. 0 disables age-based deletion. No effect without a file destination
      --log-file-max-backups string            Maximum number of rotated log files to keep. 0 keeps all files. No effect without a file destination
      --log-file-max-size string               Maximum size in megabytes of the log file before it gets rotated. 0 disables size-based rotation. No effect without a file destination
      --log-level string                       Options are debug, info, warn, error, or fatal (default info) (default "info")
      --log-outputs string                     Comma-separated list of log destinations: "stdout", "stderr", or a file path (default stdout). Merged with --log-file when both are set
      --log-timestamp-format string            Format for log timestamps, expressed as a Go time layout, e.g. '2006/01/02 15:04:05.000' (default RFC3339 with nanoseconds)
      --metadata-enabled                       Expose the placement tables on the healthz server
      --metrics-listen-address string          The address for the metrics server (default "0.0.0.0")
      --metrics-port string                    The port for the metrics server (default "9090")
      --mode string                            Runtime mode for Placement (default "standalone")
      --port int                               sets the gRPC port for the placement service (default 50005)
      --raft-logstore-path string              raft log store path.
      --replicationFactor int                  sets the replication factor for actor distribution on virtual nodes (default 100)
      --sentry-address string                  Address of the Sentry service (default "dapr-sentry.default.svc:443")
      --tls-enabled                            Should TLS be enabled for the placement gRPC server
      --trust-anchors-file string              Filepath to the trust anchors for the Dapr control plane (default "/var/run/secrets/dapr.io/tls/ca.crt")
      --trust-domain string                    Trust domain for the Dapr control plane (default "localhost")
Options (31)
OptionDescriptionSource
--disseminate-coalesce-window durationif >0, after a dissemination round completes, defer the next round by this window so additional host registers/disconnects arriving inside the window collapse into a single round.help
--disseminate-timeout durationsets the period of time in which a dissemination is considered failed if not completed.help
--enable-metricsEnable prometheus metric (default true)help
--healthz-listen-address stringThe listening address for the healthz serverhelp
--healthz-port intsets the HTTP port for the healthz server (default 8080)help
--id stringPlacement server ID (default "dapr-placement-0")help
--initial-cluster stringsraft cluster peers (default [dapr-placement-0=127.0.0.1:8201])help
--inmem-store-enabledEnable in-memory log and snapshot store unless --raft-logstore-path is set (default true)help
--keepalive-time durationsets the interval at which the placement service sends keepalive pings to daprd on the gRPC stream to check if the connection is still alive.help
--keepalive-timeout durationsets the timeout period for daprd to respond to the placement service's keepalive pings before the placement service closes the connection.help
--listen-address stringThe listening address for the placement servicehelp
--log-as-jsonprint log as JSON (default false)help
--log-file stringPath to a file where logs will be writtenhelp
--log-file-compression stringCompression for rotated log files: "none" or "gzip" (default none).help
--log-file-max-age stringMaximum number of days to retain rotated log files.help
--log-file-max-backups stringMaximum number of rotated log files to keep.help
--log-file-max-size stringMaximum size in megabytes of the log file before it gets rotated.help
--log-level stringOptions are debug, info, warn, error, or fatal (default info) (default "info")help
--log-outputs stringComma-separated list of log destinations: "stdout", "stderr", or a file path (default stdout).help
--log-timestamp-format stringFormat for log timestamps, expressed as a Go time layout, e.g. '2006/01/02 15:04:05.000' (default RFC3339 with nanoseconds)help
--metadata-enabledExpose the placement tables on the healthz serverhelp
--metrics-listen-address stringThe address for the metrics server (default "0.0.0.0")help
--metrics-port stringThe port for the metrics server (default "9090")help
--mode stringRuntime mode for Placement (default "standalone")help
--port intsets the gRPC port for the placement service (default 50005)help
--raft-logstore-path stringraft log store path.help
--replicationFactor intsets the replication factor for actor distribution on virtual nodes (default 100)help
--sentry-address stringAddress of the Sentry service (default "dapr-sentry.default.svc:443")help
--tls-enabledShould TLS be enabled for the placement gRPC serverhelp
--trust-anchors-file stringFilepath to the trust anchors for the Dapr control plane (default "/var/run/secrets/dapr.io/tls/ca.crt")help
--trust-domain stringTrust domain for the Dapr control plane (default "localhost")help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.