https://github.com/agn-7/snmp-manager

SNMP collector powered by asyncio event-loop.
https://github.com/agn-7/snmp-manager

asyncio docker docker-compose python python3 snmp snmp-collector

Last synced: about 1 year ago
JSON representation

SNMP collector powered by asyncio event-loop.

• Host: GitHub
• URL: https://github.com/agn-7/snmp-manager
• Owner: agn-7
• License: mit
• Created: 2020-05-29T21:27:59.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2022-02-22T12:03:43.000Z (over 4 years ago)
• Last Synced: 2025-03-24T22:03:42.410Z (about 1 year ago)
• Topics: asyncio, docker, docker-compose, python, python3, snmp, snmp-collector
• Language: Python
• Homepage:
• Size: 203 KB
• Stars: 8
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          
[![PyPi version](https://badgen.net/pypi/v/snmp-manager/)](https://pypi.org/project/snmp-manager/)

[![PyPi license](https://badgen.net/pypi/license/snmp-manager/)](https://pypi.com/project/snmp-manager/)

[![PyPI pyversions](https://img.shields.io/pypi/pyversions/snmp-manager.svg)](https://pypi.python.org/pypi/snmp-manager/)

[![Docker](https://badgen.net/badge/icon/docker?icon=docker&label)](https://https://docker.com/)

[![build](https://github.com/agn-7/snmp-manager/workflows/build/badge.svg)](https://github.com/agn-7/snmp-manager/actions/workflows/github-actions.yml)

[![codecov](https://codecov.io/gh/agn-7/snmp-manager/branch/master/graph/badge.svg?style=flat-square)](https://codecov.io/gh/agn-7/snmp-manager) 

[![black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black) 

# SNMP Collector Powered by Asyncio

Collecting data from SNMP Agents using `python-asyncio` method.

### Setup using docker

Up and build docker container:

```bash

docker-compose up --build -d

```

### Setup Without docker:

Install requirements: 

```bash

pip install -r requirements.txt

```

Configure the desire OID(s) and metrics: 

```bash

nano snmp_collector/config/cofig.json

```

Run:

```bash

python snmp_collector

```

### Setup through `pip`

```bash

pip install snmp-manager

```

Configuration:

Create a json config file with the following format:

```

[

  {

    "isEnable": true,

    "name": "snmp-model-1",

    "address": "192.168.1.120",

    "port": 161,

    "timeout": 1,

    "retries": 3,

    "version": 2,

    "sleep_time": 5,

    "gain": 1,

    "offset": 0,

    "community": "public",

    "metrics": [

      {

        "isEnable": true,

        "tag_name": "a-sample",

        "oid": "1.3.6.13.4.1.3.1112"

      }

    ],

    "meta_data": [{'key': 'value'}]

  }

]

``` 

Run:

```bash

python -m snmp_collector --config=

```

---

[**NOTE**]:

 - The value of `-8555` means a problem is occurred during reading data over SNMP or in connection.