Skip to content

Cross-vendor normalisation for network syslog messages, following the OpenConfig and IETF YANG models

License

Notifications You must be signed in to change notification settings

nvinzens/napalm-logs

This branch is 2 commits ahead of, 483 commits behind napalm-automation/napalm-logs:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

author
nvinzens
Mar 15, 2018
d63379d · Mar 15, 2018
Nov 8, 2017
Nov 6, 2017
Mar 15, 2018
Jul 13, 2017
Mar 15, 2018
Jul 31, 2017
Aug 4, 2017
Jul 11, 2017
Mar 16, 2017
Jul 28, 2017
Sep 6, 2017
Sep 6, 2017
Mar 19, 2017
Aug 10, 2017
Jul 7, 2017
Aug 8, 2017
Oct 4, 2017
Jul 28, 2017

Repository files navigation

napalm-logs

napalm-logs is a Python library that listens to syslog messages from network devices and returns strucuted data following the OpenConfig or IETF YANG models.

The outgoing objects are published via ZeroMQ, Kafka, or other usual transport options. It is easy enough to switch between transports and pluggable to add others such as Google Datastore, RabbitMQ, etc.

Similarly, the syslog messages can be received via UDP, TCP, or different services, such as Kafka, etc.

New platforms can be easily added, just referencing the path to the YAML configuration file.

Requirements

  • PyYAML
  • PyZMQ
  • PyNaCl
  • u-msgpack-python

Output object example

{
  "yang_message": {
    "bgp": {
      "neighbors": {
        "neighbor": {
          "192.168.140.254": {
            "state": {
              "peer_as": "65001"
            },
            "afi_safis": {
              "afi_safi": {
                "inet4": {
                  "state": {
                    "prefixes": {
                      "received": 141
                    }
                  },
                  "ipv4_unicast": {
                    "prefix_limit": {
                      "state": {
                        "max_prefixes": 140
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "message_details": {
    "processId": "2902",
    "facility": 18,
    "severity": 5,
    "hostPrefix": null,
    "pri": "149",
    "processName": "rpd",
    "host": "vmx01",
    "tag": "BGP_PREFIX_THRESH_EXCEEDED",
    "time": "14:03:12",
    "date": "Jun 21",
    "message": "192.168.140.254 (External AS 65001): Configured maximum prefix-limit threshold(140) exceeded for inet4-unicast nlri: 141 (instance master)"
  },
  "timestamp": 1498050192,
  "facility": 18,
  "ip": "127.0.0.1",
  "host": "vmx01",
  "yang_model": "openconfig-bgp",
  "error": "BGP_PREFIX_THRESH_EXCEEDED",
  "os": "junos",
  "severity": 5
}

Documentation

Please check the official documentation for more detailed information.

Installation

pip install napalm-logs

About

Cross-vendor normalisation for network syslog messages, following the OpenConfig and IETF YANG models

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%