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

# Osquery

> OpenTelemetry receiver for Osquery

# Osquery Receiver

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

**Maintainers:** [@smithclay](https://github.com/smithclay)

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

## Supported Telemetry

![Logs](https://img.shields.io/badge/logs-alpha-blue)

## Overview

## Configuration

The following settings are required:

* `queries`: list of queries to run on an osquery daemon

The following settings are optional:

* `collection_interval` (default = 10s): How often queries are run on the system
* `extensions_socket` (default = `/var/osquery/osquery.em`): The osquery daemon's extension socket. Used to communicate with osquery on the system.

## Getting started

[osquery](https://osquery.io/) must be installed on the system where the collector is running. Once running as a daemon, the collector can connect to it using osquery's extension socket.

Example queries and data sources for querying are available in the [osquery docs](https://osquery.io/).

## Example configuration

```
  osquery:
    collection_internal: 10s
    extensions_socket: /var/osquery/osquery.em
    queries:
      - "select * from certificates"
      - "select * from block_devices"
```

***

*Last generated: 2026-07-06*