Registry / observability / genie-telemetry

genie-telemetry

library26.5pypypiunverified

Genie Telemetry is part of the Cisco Genie framework, providing libraries for telemetry collection, monitoring, and triggering actions on network devices. It wraps pyATS/Genie testbed infrastructure to enable real-time telemetry data extraction and event-driven automation. Current version 26.3. Release cadence is periodic, tied to Genie/pyATS ecosystem updates.

observability devops data

pip install genie-telemetry

package ↗homepage ↗

INSTALL

IMPORT

SIG · GENIE-TELEMETRY

genie-telemetry

observabilitypythonv26.5

Install

36.8s avg

Import

—

Disk

685MB

Pass rate

7/ 10

Env Coverage7 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v26.5 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✓ —

✓ 34.55s

py 3.11

✕ build_error

✓ 33.4s

py 3.12

✕ build_error

✓ 37s

py 3.13

✕ build_error

✓ 35.7s

py 3.9

✓ —

✓ 43.25s

685MB installed

● package 685MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

TelemetryCollector

✓ from genie.telemetry import TelemetryCollector

✗ from genie.telemetry import TelemetryCollector

Basic usage: load testbed, connect to device, create telemetry collector, add a CPU agent, collect data.

from pyats.topology import loader from genie.telemetry import TelemetryCollector, Agent # Load testbed testbed = loader.load('testbed.yaml') device = testbed.devices['router1'] device.connect() # Create telemetry collector collector = TelemetryCollector(device=device) collector.add_agent(Agent(device=device, what='cpu')) collector.start() results = collector.stop() print(results)

Debug

Known issues

breakingIn genie-telemetry v25+, the 'Agent' class is no longer importable from 'genie.telemetry.agent'; import directly from 'genie.telemetry'.

fix

Use 'from genie.telemetry import Agent' instead of 'from genie.telemetry.agent import Agent'.

affects: >=25.0

gotchaThe 'TelemetryCollector' must be started and stopped explicitly; forgetting to stop can leave orphaned processes.

fix

Always call collector.stop() in a try/finally block or use context manager if available.

affects: all

deprecatedSupport for older telemetry protocols (e.g., MDT over gRPC) is being phased out in favor of gNMI.

fix

Migrate to gNMI collectors using 'from genie.telemetry.gnmi import GnmiCollector'.

affects: >=26.0

Upgrade

Version history

26.5latest on PyPI · released May 28, 2026

Audit

Dependencies

genierequiredCore Genie framework for testbed and device abstractions

pyatsrequiredpyATS testbed and connection management

grpciooptionalgRPC support for telemetry streaming (e.g., gRPC Dial-out)

Agent activity

20 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/genie-telemetry/ ↗

homepagehttps://developer.cisco.com/pyats ↗