---
title: ''
description: Telegraf plugin for collecting metrics from LeoFS
url: https://docs.influxdata.com/telegraf/v1/input-plugins/leofs/
estimated_tokens: 1669
product: Telegraf Controller
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/input-plugins/leofs/
date: '2026-05-21T20:10:18+02:00'
lastmod: '2026-05-21T20:10:18+02:00'
---

==========

* Telegraf v0.1.5+

[Plugin source](https://github.com/influxdata/telegraf/tree/v1.39.0/plugins/inputs/leofs/)[Download configuration](https://raw.githubusercontent.com/influxdata/telegraf/refs/tags/v1.39.0/plugins/inputs/leofs/sample.conf)

# LeoFS Input Plugin

This plugin gathers metrics of the [LEO filesystem](https://leo-project.net/leofs/) services*LeoGateway*, *LeoManager*, and *LeoStorage* via SNMP. Check the[LeoFS system monitoring documentation](https://leo-project.net/leofs/docs/admin/system_admin/monitoring/) for details.

**Introduced in:** Telegraf v0.1.5**Tags:** network, server**OS support:** all

## Global configuration options

Plugins support additional global and plugin configuration settings for tasks
such as modifying metrics, tags, and fields, creating aliases, and configuring
plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
# Read metrics from a LeoFS Server via SNMP
[[inputs.leofs]]
  ## An array of URLs of the form:
  ##   host [ ":" port]
  servers = ["127.0.0.1:4010"]
```

## Metrics

### Statistics specific to the internals of LeoManager

#### Erlang VM of LeoManager

* 1 min Statistics
  * num\_of\_processes
  * total\_memory\_usage
  * system\_memory\_usage
  * processes\_memory\_usage
  * ets\_memory\_usage
  * used\_allocated\_memory
  * allocated\_memory

* 5 min Statistics
  * num\_of\_processes\_5min
  * total\_memory\_usage\_5min
  * system\_memory\_usage\_5min
  * processes\_memory\_usage\_5min
  * ets\_memory\_usage\_5min
  * used\_allocated\_memory\_5min
  * allocated\_memory\_5min

### Statistics specific to the internals of LeoStorage

### Erlang VM of LeoStorage

* 1 min Statistics
  * num\_of\_processes
  * total\_memory\_usage
  * system\_memory\_usage
  * processes\_memory\_usage
  * ets\_memory\_usage
  * used\_allocated\_memory
  * allocated\_memory

* 5 min Statistics
  * num\_of\_processes\_5min
  * total\_memory\_usage\_5min
  * system\_memory\_usage\_5min
  * processes\_memory\_usage\_5min
  * ets\_memory\_usage\_5min
  * used\_allocated\_memory\_5min
  * allocated\_memory\_5min

### Total Number of Requests for LeoStorage

* 1 min Statistics
  * num\_of\_writes
  * num\_of\_reads
  * num\_of\_deletes

* 5 min Statistics
  * num\_of\_writes\_5min
  * num\_of\_reads\_5min
  * num\_of\_deletes\_5min

#### Total Number of Objects and Total Size of Objects

* num\_of\_active\_objects
* total\_objects
* total\_size\_of\_active\_objects
* total\_size

#### Total Number of MQ Messages

* num\_of\_replication\_messages,
* num\_of\_sync-vnode\_messages,
* num\_of\_rebalance\_messages,
* mq\_num\_of\_msg\_recovery\_node
* mq\_num\_of\_msg\_deletion\_dir
* mq\_num\_of\_msg\_async\_deletion\_dir
* mq\_num\_of\_msg\_req\_deletion\_dir
* mq\_mdcr\_num\_of\_msg\_req\_comp\_metadata
* mq\_mdcr\_num\_of\_msg\_req\_sync\_obj

Note: The following items are available since LeoFS v1.4.0:

* mq\_num\_of\_msg\_recovery\_node
* mq\_num\_of\_msg\_deletion\_dir
* mq\_num\_of\_msg\_async\_deletion\_dir
* mq\_num\_of\_msg\_req\_deletion\_dir
* mq\_mdcr\_num\_of\_msg\_req\_comp\_metadata
* mq\_mdcr\_num\_of\_msg\_req\_sync\_obj

#### Data Compaction

* comp\_state
* comp\_last\_start\_datetime
* comp\_last\_end\_datetime
* comp\_num\_of\_pending\_targets
* comp\_num\_of\_ongoing\_targets
* comp\_num\_of\_out\_of\_targets

Note: The all items are available since LeoFS v1.4.0.

### Statistics specific to the internals of LeoGateway

#### Erlang VM of LeoGateway

* 1 min Statistics
  * num\_of\_processes
  * total\_memory\_usage
  * system\_memory\_usage
  * processes\_memory\_usage
  * ets\_memory\_usage
  * used\_allocated\_memory
  * allocated\_memory

* 5 min Statistics
  * num\_of\_processes\_5min
  * total\_memory\_usage\_5min
  * system\_memory\_usage\_5min
  * processes\_memory\_usage\_5min
  * ets\_memory\_usage\_5min
  * used\_allocated\_memory\_5min
  * allocated\_memory\_5min

#### Total Number of Requests for LeoGateway

* 1 min Statistics
  * num\_of\_writes
  * num\_of\_reads
  * num\_of\_deletes

* 5 min Statistics
  * num\_of\_writes\_5min
  * num\_of\_reads\_5min
  * num\_of\_deletes\_5min

#### Object Cache

* count\_of\_cache-hit
* count\_of\_cache-miss
* total\_of\_files
* total\_cached\_size

### Tags

All measurements have the following tags:

* node

## Example Output

### LeoManager

```text
leofs,host=manager_0,node=manager_0@127.0.0.1 allocated_memory=78255445,allocated_memory_5min=78159025,ets_memory_usage=4611900,ets_memory_usage_5min=4632599,num_of_processes=223,num_of_processes_5min=223,processes_memory_usage=20201316,processes_memory_usage_5min=20186559,system_memory_usage=37172701,system_memory_usage_5min=37189213,total_memory_usage=57373373,total_memory_usage_5min=57374653,used_allocated_memory=67,used_allocated_memory_5min=67 1524105758000000000
```

### LeoStorage

```text
leofs,host=storage_0,node=storage_0@127.0.0.1 allocated_memory=63504384,allocated_memory_5min=0,comp_last_end_datetime=0,comp_last_start_datetime=0,comp_num_of_ongoing_targets=0,comp_num_of_out_of_targets=0,comp_num_of_pending_targets=8,comp_state=0,ets_memory_usage=3877824,ets_memory_usage_5min=0,mq_mdcr_num_of_msg_req_comp_metadata=0,mq_mdcr_num_of_msg_req_sync_obj=0,mq_num_of_msg_async_deletion_dir=0,mq_num_of_msg_deletion_dir=0,mq_num_of_msg_recovery_node=0,mq_num_of_msg_req_deletion_dir=0,num_of_active_objects=70,num_of_deletes=0,num_of_deletes_5min=0,num_of_processes=577,num_of_processes_5min=0,num_of_reads=1,num_of_reads_5min=0,num_of_rebalance_messages=0,num_of_replication_messages=0,num_of_sync-vnode_messages=0,num_of_writes=70,num_of_writes_5min=0,processes_memory_usage=20029464,processes_memory_usage_5min=0,system_memory_usage=25900472,system_memory_usage_5min=0,total_memory_usage=45920987,total_memory_usage_5min=0,total_objects=70,total_size=2,total_size_of_active_objects=2,used_allocated_memory=69,used_allocated_memory_5min=0 1524529826000000000
```

### LeoGateway

```text
leofs,host=gateway_0,node=gateway_0@127.0.0.1 allocated_memory=87941120,allocated_memory_5min=88067672,count_of_cache-hit=0,count_of_cache-miss=0,ets_memory_usage=4843497,ets_memory_usage_5min=4841574,num_of_deletes=0,num_of_deletes_5min=0,num_of_processes=555,num_of_processes_5min=555,num_of_reads=0,num_of_reads_5min=0,num_of_writes=0,num_of_writes_5min=0,processes_memory_usage=17388052,processes_memory_usage_5min=17413928,system_memory_usage=49531263,system_memory_usage_5min=49577819,total_cached_size=0,total_memory_usage=66917393,total_memory_usage_5min=66989469,total_of_files=0,used_allocated_memory=69,used_allocated_memory_5min=69 1524105894000000000
```
