> ## Documentation Index
> Fetch the complete documentation index at: https://otel.fyi/llms.txt
> Use this file to discover all available pages before exploring further.

# Windowsservice

> OpenTelemetry receiver for Windowsservice

# Windowsservice Receiver

![Status](https://img.shields.io/badge/status-alpha-red)

**Available in:** `contrib`

**Maintainers:** [@pjanotti](https://github.com/pjanotti), [@shalper2](https://github.com/shalper2)

**Source:** [opentelemetry-collector-contrib](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/windowsservicereceiver)

## Supported Telemetry

![Metrics](https://img.shields.io/badge/metrics-alpha-green)

## Overview

## Getting Started

By default the Windows Service Receiver will attempt to identify and monitor the status of all specified services on the host machine.

An example of monitoring three services on a host:

```yaml theme={null}
windows_service:
  collection_interval: <duration> # default = 1m
  include_services:
    - service1
    - service2
    - service3
    ...
```

The case where you wish to monitor all services present on a host machine, except for `service3`:

```yaml theme={null}
windows_service:
  collection_interval: <duration> # default = 1m
  include_services:
  exclude_services:
    - service3
    ...
```

## Metrics

| Metric Name                | Description                                                | Unit      | Type  | Attributes          |
| -------------------------- | ---------------------------------------------------------- | --------- | ----- | ------------------- |
| ✅ `windows.service.status` | Gauge value containing service status as an integer value. | \{status} | Gauge | name, startup\_mode |

## Attributes

| Attribute Name | Description                                     | Type   | Values                                                                 |
| -------------- | ----------------------------------------------- | ------ | ---------------------------------------------------------------------- |
| `name`         | The name of the windows Service being reported. | string |                                                                        |
| `startup_mode` | Startup mode of Windows Service                 | string | `boot_start`, `system_start`, `auto_start`, `demand_start`, `disabled` |

***

*Last generated: 2026-07-06*