ray.util.state.common.ActorState#
- class ray.util.state.common.ActorState(actor_id: str, class_name: str, state: Literal['DEPENDENCIES_UNREADY', 'PENDING_CREATION', 'ALIVE', 'RESTARTING', 'DEAD'], job_id: str, name: str | None, node_id: str | None, pid: int | None, ray_namespace: str | None, serialized_runtime_env: str | None = None, required_resources: dict | None = None, death_cause: dict | None = None, is_detached: bool | None = None, placement_group_id: str | None = None, repr_name: str | None = None, num_restarts: int = None, num_restarts_due_to_lineage_reconstruction: int = None, num_restarts_due_to_node_preemption: int = None, call_site: str | None = None, label_selector: dict | None = None)[source]#
Bases:
StateSchema
Actor State
Below columns can be used for the
--filter
option.class_name
job_id
state
placement_group_id
actor_id
pid
ray_namespace
name
node_id
repr_name
Below columns are available only when
get
API is used,--detail
is specified through CLI, ordetail=True
is given to Python APIs.class_name
call_site
state
placement_group_id
pid
job_id
repr_name
label_selector
death_cause
num_restarts_due_to_lineage_reconstruction
actor_id
is_detached
required_resources
node_id
num_restarts_due_to_node_preemption
serialized_runtime_env
num_restarts
ray_namespace
name
- state: Literal['DEPENDENCIES_UNREADY', 'PENDING_CREATION', 'ALIVE', 'RESTARTING', 'DEAD']#
The state of the actor.
DEPENDENCIES_UNREADY: Actor is waiting for dependency to be ready. E.g., a new actor is waiting for object ref that’s created from other remote task.
PENDING_CREATION: Actor’s dependency is ready, but it is not created yet. It could be because there are not enough resources, too many actor entries in the scheduler queue, or the actor creation is slow (e.g., slow runtime environment creation, slow worker startup, or etc.).
ALIVE: The actor is created, and it is alive.
RESTARTING: The actor is dead, and it is restarting. It is equivalent to
PENDING_CREATION
, but means the actor was dead more than once.DEAD: The actor is permanatly dead.
- node_id: str | None#
The node id of this actor. If the actor is restarting, it could be the node id of the dead actor (and it will be re-updated when the actor is successfully restarted).
- death_cause: dict | None = None#
Actor’s death information in detail. None if the actor is not dead yet.
- repr_name: str | None = None#
Actor’s repr name if a customized __repr__ method exists, else empty string.
- num_restarts_due_to_lineage_reconstruction: int = None#
Number of times this actor is restarted due to lineage reconstructions.