### MetricsHub
MetricsHub 1.0.00

Home

Connectors directory[1] Full listing of connectors[2]

## Linux - Service (systemctl)

### Description

Gives OS specific service information and metrics

community[3] linux[4] system[5]

Source[6]

### Target

Typical platform: Linux[7]

Operating system: Linux

### Prerequisites

Leverages: Linux OsCommands

Technology and protocols: Commands

Variables:

- `serviceNames`: Regular expression pattern to identify the services to monitor. (default: `.*`)

### Examples

#### CLI

    metricshub HOSTNAME -t linux -c +LinuxService --ssh -u USER

#### metricshub.yaml

    resourceGroups:
      <RESOURCE_GROUP>:
        resources:
          <HOSTNAME-ID>:
            attributes:
              host.name: <HOSTNAME> # Change with actual host name
              host.type: linux
            connectors: [ +LinuxService ] # Optional, to load only this connector
            protocols:
              ssh:
                username: <USERNAME> # Change with actual credentials
                password: <PASSWORD> # Encrypted using metricshub-encrypt
            additionalConnectors:
              LinuxService: # Unique ID. Use 'uses' if different from the original connector ID
                uses: LinuxService # Optional - Original ID if not in key
                force: true # Optional (default: true); false for auto-detection only
                variables:
                  serviceNames: <VALUE> # Replace with desired value.

### Connector Activation Criteria

The Linux - Service (systemctl) connector must be selected manually, and its status will be reported as OK if all the below criteria are met:

- The command below succeeds on the monitored host
  - Command: `/usr/bin/systemctl`
  - Output contains: `UNIT` (regex)

### Metrics

Type | Collected Metrics | Specific Attributes
--- | --- | ---
service | `system.service.status{state="active"}` `system.service.status{state="dead|exited|running"}` `system.service.status{state="loaded"}` | `id`

monitoring observability opentelemetry otel
Links:

- [1] ../metricshub-connectors-directory.html
- [2] ../metricshub-connectors-full-listing.html
- [3] tags/community.html
- [4] tags/linux.html
- [5] tags/system.html
- [6] https://github.com/sentrysoftware/metricshub-community-connectors/tree/main/src/main/connector/system/LinuxService/LinuxService.yaml
- [7] platforms/linux.html

## Search Results for {{siteSearch | truncate:'50'}}

{{resultArray.length}}
{{parent.title}} {{parent.title}}

{{result.title}}

{{result.body | truncate:'400'}}

{{parent.title}}
{{result.title}}
{{result.body | truncate:'100'}}

No results.