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

# Ntp

> OpenTelemetry receiver for Ntp

# Ntp Receiver

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

**Available in:** `contrib`

**Maintainers:** [@atoulme](https://github.com/atoulme), [@paulojmdias](https://github.com/paulojmdias)

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

## Supported Telemetry

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

## Overview

## Configuration

* `endpoint`: (default = `pool.ntp.org:123`) Endpoint of the NTP server. Must be formatted as `{host}:{port}`.

* `collection_interval`: (default = `30m`): This receiver collects metrics on an interval. This value must be a string readable by Golang's [time.ParseDuration](https://pkg.go.dev/time#ParseDuration). Valid time units are `ns`, `us` (or `µs`), `ms`, `s`, `m`, `h`.

* `initial_delay` (default = `1s`): defines how long this receiver waits before starting.

* `metrics` (default: see DefaultMetricsSettings [here](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/ntpreceiver/internal/metadata/generated_metrics.go)): Allows enabling and disabling specific metrics from being collected in this receiver.

### Example Configuration

```yaml theme={null}
receivers:
  ntp:
    endpoint: pool.ntp.org:123
    collection_interval: 1h
    initial_delay: 5m
```

The full list of settings exposed for this receiver are documented in [config.go](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/ntpreceiver/config.go) with detailed sample configurations in [testdata/config.yaml](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/ntpreceiver/internal/metadata/testdata/config.yaml).

## Metrics

Details about the metrics produced by this receiver can be found in [metadata.yaml](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/ntpreceiver/metadata.yaml)

## Metrics

| Metric Name    | Description                                         | Unit | Type  | Attributes |
| -------------- | --------------------------------------------------- | ---- | ----- | ---------- |
| ✅ `ntp.offset` | Time difference between local and NTP server clocks | ns   | Gauge |            |

## Resource Attributes

| Attribute Name | Description                                        | Type   | Enabled |
| -------------- | -------------------------------------------------- | ------ | ------- |
| `ntp.host`     | NTP server used. Corresponds to configured `host`. | string | ✅       |

***

*Last generated: 2026-07-06*