/ home / ansible / ansible.builtin / v2.8.20 / module / service_facts

ansible.builtin.service_facts (v2.8.20) — module

Return service state information as fact data

| "added in version" 2.5 of ansible.builtin"

Authors: Adam Miller (@maxamillion)

preview | supported by community

Install Ansible via `pip`

Install with pip install ansible==2.8.20

Description

Return service state information as fact data for various service management utilities

Requirements

Any of the following supported init systems: systemd, sysv, upstart

Usage examples

Scanned by Steampunk Spotter

- name: populate service facts
  service_facts:

Scanned by Steampunk Spotter

- debug:
    var: ansible_facts.services

Outputs

ansible_facts:
  contains:
    services:
      contains:
        name:
          description: Name of the service.
          returned: always
          sample: arp-ethers.service
          type: str
        source:
          description: Init system of the service. One of C(systemd), C(sysv), C(upstart).
          returned: always
          sample: sysv
          type: str
        state:
          description: State of the service. Either C(running), C(stopped), or C(unknown).
          returned: always
          sample: running
          type: str
        status:
          description: State of the service. Either C(enabled), C(disabled), or C(unknown).
          returned: systemd systems or RedHat/SUSE flavored sysvinit/upstart
          sample: enabled
          type: str
      description: States of the services with service name as key.
      returned: always
      type: complex
  description: Facts to add to ansible_facts about the services on the system
  returned: always
  type: complex