B.16 graph.*

4 min read

Every field the catalogue defines under graph, in path order. Each entry gives the field's definition and, under Carried by, every event type that writes it.

B.16.1 graph.context #

  • Type: uint
  • Asserted: no
  • Carried in: the payload
  • Defined in: peinit.evman

The graph execution context an event belongs to: one boot's start of its service set, or one on-demand start of a service and everything it needs. Records with the same context belong to one attempt to bring a set of services up.

Numbered from 0 in the order peinit creates contexts. Not durable: the numbering starts again when peinit does.

Carried by:

B.16.2 graph.counts.added #

  • Type: uint
  • Asserted: no
  • Carried in: the payload
  • Defined in: peinit.evman

How many service definitions a configuration reload added: names that had no definition before.

Written only when the reload succeeded. A failed reload changed nothing, and carries no counts.

Carried by:

B.16.3 graph.counts.discarded #

  • Type: uint
  • Asserted: no
  • Carried in: the payload
  • Defined in: peinit.evman

How many definitions a configuration reload withdrew and dropped at once, because their services were not running. Written only when the reload succeeded, as graph.counts.added is.

Carried by:

B.16.4 graph.counts.marked-removed #

  • Type: uint
  • Asserted: no
  • Carried in: the payload
  • Defined in: peinit.evman

How many definitions a configuration reload withdrew from services that were still running. Such a service is left running, cannot be started again, and is discarded once it stops. Written only when the reload succeeded, as graph.counts.added is.

Carried by:

B.16.5 graph.counts.restored #

  • Type: uint
  • Asserted: no
  • Carried in: the payload
  • Defined in: peinit.evman

How many definitions a configuration reload brought back after an earlier reload had removed them while their services were still running. Written only when the reload succeeded, as graph.counts.added is.

Carried by:

B.16.6 graph.counts.undecodable #

  • Type: uint
  • Asserted: no
  • Carried in: the payload
  • Defined in: peinit.evman

How many definitions a configuration reload found in the registry but could not decode. Each such service is failed, or, if it was running, left running with its definition marked removed. Not counted under graph.counts.marked-removed or graph.counts.discarded, because the key is still there. Written only when the reload succeeded, as graph.counts.added is.

Carried by:

B.16.7 graph.counts.updated #

  • Type: uint
  • Asserted: no
  • Carried in: the payload
  • Defined in: peinit.evman

How many existing service definitions a configuration reload changed. Written only when the reload succeeded, as graph.counts.added is.

Carried by:

B.16.8 graph.phase #

  • Type: str.enum
  • Values: boot · reload-config · phase2-boot
  • Set: open
  • Asserted: no
  • Carried in: the payload
  • Defined in: peinit.evman

When the service graph was validated. The phase changes what a finding did: at boot, the services it names are marked and the boot continues; at reload-config, the whole reload is rejected and nothing is applied; at phase2-boot, the boot plan itself could not be built.

Carried by:

B.16.9 graph.role #

  • Type: str
  • Asserted: no
  • Carried in: the payload
  • Defined in: peinit.evman

The role no service fills. A role is a virtual name a service declares it provides, such as authn, and other services depend on the role rather than on a service name. The services that need it are in graph.services.

Carried by:

B.16.10 graph.services #

  • Type: str[]
  • Asserted: no
  • Carried in: the payload
  • Defined in: peinit.evman

The services a graph finding involves. For a dependency cycle, the services in the cycle, in the order the cycle runs; for an unfilled role, the services that need the role and cannot start; for a reload during the boot window, the services whose definitions were deferred.

Carried by:

Generated from peinit.evman by pkm/tools/gen-events-book.py. Edit the fragment, not this page.

Edit this page