---
id: pyats-log
version: "26.7"
license: Apache 2.0
license_treatment: permissive
maintenance: active
---

# pyats.log — pyATS Log: Logging Format and Utilities

License: permissive · Maintenance: active · Downloads: 295.0K/mo

## What it is and what it does

pyats.log is a logging subcomponent of the pyATS end-to-end testing framework, developed by Cisco. It provides formatters and utilities to emit test logs in Cisco's standard log format, integrating with the broader pyATS ecosystem for data-driven and reusable testing. The package wraps Python's logging module and depends on 9 runtime libraries including aiohttp, pyyaml, jinja2, and async utilities, suggesting support for both synchronous and asynchronous logging contexts.

The package is actively maintained (latest release 26.7 from August 2026) and supports modern Python versions 3.8 through 3.14 with prebuilt wheels for macOS and Linux. It is positioned as a utility for developers, system administrators, and test engineers working within the pyATS testing framework, particularly in telecommunications and network automation contexts.

Use it for:

- Format test logs to Cisco standard format when running pyATS test suites in network automation workflows.
- Integrate structured logging into pyATS test cases to ensure compliance with enterprise log standards.
- Emit asynchronous test logs from concurrent test scenarios using pyATS's async capabilities.
- Standardize log output across heterogeneous test environments using a shared Cisco log format.
- Build custom logging handlers on top of pyATS log utilities for specialized test reporting.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides logging format and utilities for pyATS, enabling test output to conform to Cisco log format standards.

Yes, if you are using pyATS for testing and need Cisco-compliant log formatting. The package is actively maintained, permissively licensed, and well-integrated into the pyATS ecosystem. Install friction is moderate due to multiple async dependencies, but prebuilt wheels minimize compilation overhead. Not relevant outside the pyATS testing context.

## Install

pip install pyats-log
uv add pyats-log
poetry add pyats-log

## Installing pyats.log

Before you install: Active maintenance with a release 7 days ago. Medium install friction due to 9 runtime dependencies including aiohttp, pyyaml, and async utilities. Supports Python 3.10–3.14 with prebuilt wheels across macOS, Linux, and ARM architectures.

License in practice: Licensed under Apache 2.0 (permissive), allowing use in commercial and open-source projects with minimal restrictions.

Quickstart:

pip install pyats.log

from pyats.log import logging

logger = logging.getLogger(__name__)
logger.info('Test message')

Requires Python 3.8 or later; Linux and macOS only (Windows not supported per documentation).

Verify before relying:

- Specific Cisco log format schema or output examples not detailed in excerpt.
- Whether async_lru, aiofiles, and socketio dependencies are always required or only for certain features.
- Integration points with the broader pyATS ecosystem beyond the logs subcomponent.

## Package facts

- License: Apache 2.0 (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 295.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pyats logging formatter, cisco log format output, pyats test logging, structured logging for testing, log formatting utilities, pyats component logging, test framework logging, cisco-networking, test-logging, async-logging

[View on SkillFed](https://skillfed.io/packages/pyats-log) · [View on PyPI](https://pypi.org/project/pyats-log/)