Metadata-Version: 2.4
Name: nautobot_app_livedata
Version: 3.0.0
Summary: Provides a live view of network data within Nautobot.
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: nautobot,nautobot-app,nautobot-plugin
Author: Josef Fuchs
Author-email: josef.fuchs@j-fuchs.at
Requires-Python: >=3.10,<3.14
Classifier: Intended Audience :: Developers
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: h11 (>=0.16.0,<1.0.0)
Requires-Dist: jsonschema (>=4.7.0,<5.0.0)
Requires-Dist: mysqlclient (>=2.2.8,<3.0.0)
Requires-Dist: nautobot (==3.0.0) ; python_version == "3.13"
Requires-Dist: nautobot-plugin-nornir (>=3.0.0,<3.1.0)
Requires-Dist: python-dotenv (>=1.2.1,<1.3.0)
Requires-Dist: to-json-schema (>=1.0.1,<1.1.0)
Project-URL: Documentation, https://nautobot-app-livedata.readthedocs.io/en/latest/
Project-URL: Homepage, https://github.com/jifox/nautobot-app-livedata.git
Project-URL: Repository, https://github.com/jifox/nautobot-app-livedata.git
Description-Content-Type: text/markdown

# Nautobot App Livedata

![Nautobot App Livedata logo](https://raw.githubusercontent.com/jifox/Nautobot-app-livedata/develop/docs/images/icon-livedata.png)

[![CI Status](https://github.com/jifox/Nautobot-app-livedata/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/jifox/Nautobot-app-livedata/actions)
[![Docs Status](https://readthedocs.org/projects/Nautobot-app-livedata/badge/)](https://Nautobot-app-livedata.readthedocs.io/en/latest/)
[![PyPI Version](https://img.shields.io/pypi/v/Nautobot-app-livedata)](https://pypi.org/project/Nautobot-app-livedata/)
[![PyPI Downloads](https://img.shields.io/pypi/dm/Nautobot-app-livedata)](https://pypi.org/project/Nautobot-app-livedata/)

An [App](https://networktocode.com/Nautobot-apps/) for [Nautobot](https://Nautobot.com/).

## Overview

Lightweight Nautobot plugin that fetches and displays live device and interface command output (via Netmiko) in Nautobot UI detail views.

**Compatibility:** Nautobot 3.0+.

**Primary features:**

- Live Data tabs on `Device` and `Interface` detail pages.
- Configurable per-platform show commands (set at Platform objects).
- Inline filtering of command output using `!!` filter syntax (EXACT/LAST/FIRST).
- Background jobs included for scheduling and housekeeping:
    - `LivedataQueryJob` — run queries against devices.
    - `LivedataCleanupJobResultsJob` — remove stale collected results.
    - `EnforceDefaultJobQueueJob` — align Job queue assignments with a default worker queue.

### Screenshots

- Live Data Interface Output for interfaces

  ![Livedata output screenshot](https://raw.githubusercontent.com/jifox/nautobot-app-livedata/develop/docs/images/livedata-app-output.png)

- Live Data Device Output for devices

  ![Livedata output screenshot](https://raw.githubusercontent.com/jifox/nautobot-app-livedata/develop/docs/images/livedata-device-output.png)

- Configure the show commands to be executed on Platform level:

  ![Platform Screenshot](https://raw.githubusercontent.com/jifox/nautobot-app-livedata/develop/docs/images/livedata-platform-detail.png)

- Job to clean up old data:

  ![Cleanup Job Results Screenshot](https://raw.githubusercontent.com/jifox/nautobot-app-livedata/develop/docs/images/livedata-app-cleanup-job-results.png)

- Job to align Nautobot job queues with the default worker so every Job executes on the shared Celery queue.

More screenshots can be found in the [Using the App](https://nautobot-app-livedata.readthedocs.io/en/latest/user/app_use_cases/) page in the documentation. Here's a quick overview of some of the app's added functionality:

## Documentation

Full documentation for this App can be found over on the [Nautobot-App-Livedtata Docs](https://nautobot-app-livedata.readthedocs.io/en/latest) website:

- [User Guide](https://nautobot-app-livedata.readthedocs.io/en/latest/user/app_overview/) - Overview, Using the App, Getting Started.
- [Administrator Guide](https://nautobot-app-livedata.readthedocs.io/en/latest/admin/install/) - How to Install, Configure, Upgrade, or Uninstall the App.
- [Developer Guide](https://nautobot-app-livedata.readthedocs.io/en/latest/dev/contributing/) - Extending the App, Code Reference, Contribution Guide.
- [Release Notes / Changelog](https://nautobot-app-livedata.readthedocs.io/en/latest/admin/release_notes/).
- [Frequently Asked Questions](https://nautobot-app-livedata.readthedocs.io/en/latest/user/faq/).

### Contributing to the Documentation

You can find all the Markdown source for the App documentation under the [`docs`](https://github.com/jifox/nautobot-app-livedata/tree/develop/docs) folder in this repository. For simple edits, a Markdown capable editor is sufficient: clone the repository and edit away.

If you need to view the fully-generated documentation site, you can build it with [MkDocs](https://www.mkdocs.org/). A container hosting the documentation can be started using the `invoke` commands (details in the [Development Environment Guide](https://nautobot-app-livedata.readthedocs.io/en/latest/dev/dev_environment/#docker-development-environment)) on [http://localhost:8001](http://localhost:8001). Using this container, as your changes to the documentation are saved, they will be automatically rebuilt and any pages currently being viewed will be reloaded in your browser.

Any PRs with fixes or improvements are very welcome!

## Questions

For any questions or comments, please check the [FAQ](https://nautobot-app-livedata.readthedocs.io/en/latest/user/faq/) first. Feel free to also swing by the [Network to Code Slack](https://networktocode.slack.com/) (channel `#nautobot`), sign up [here](http://slack.networktocode.com/) if you don't have an account.

## Support for Filter Commands in Live Device Output Using !! Syntax

### Filter Syntax

You can now append a filter command to the end of a device command using the `!!` delimiter. The string following `!!` specifies the filter operation to be applied to the command output.

#### Examples

- `show logging | i {{intf_number}} !!EXACT:{{intf_number}}!!` — Filters the output to contain only lines that contain the interface number as a whole word (for example, matches `Gi1/0/1`, `1/0/1` with trailing whitespace, `^1/0/1`, or `1/0/1$` but not `11/0/1`, `1/0/11`, or `foo1/0/1bar`).
- `show logging !!LAST:100!!` — Returns only the last 100 lines of the output.
- `show logging !!FIRST:10!!` — Returns only the first 10 lines of the output.
- `show logging !!EXACT:{{intf_number}}!!FIRST:5!!` — Filters for lines containing the interface number, then returns only the first 5 matching lines.

### Supported Filters

- `!!EXACT:<pattern>!!` — Only lines that contain `<pattern>` as a whole word (ignoring leading/trailing whitespace, not matching substrings within other numbers or words)
- `!!LAST:<N>!!` — Only the last N lines
- `!!FIRST:<N>!!` — Only the first N lines

Additional filters may be added in the future.

This feature provides a consistent filtering mechanism across all supported platforms, reducing the need for custom scripts or manual output parsing.

---

