ara

library1.7.5pypypi✓ verified 80d ago

ARA (Ansible Records Ansible) is a callback plugin and web UI for recording and browsing Ansible playbook runs. It captures detailed data about tasks, plays, and hosts. The current version is 1.7.5. Release is on-demand, typically monthly.

devops observability

pip install ara

package ↗homepage ↗

INSTALL

IMPORT

SIG · ARA

ara

devopspythonv1.7.5

Install

6.2s avg

Import

—

Disk

48MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.7.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

py 3.10–3.910 runs

installs and imports cleanly · install 0.0s · import 0.000s · 48.1MB

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 6.2s · import 0.000s · 49MB

48MB installed

● package 48MB

Code

Verified usage

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

setup_callback_plugins

✓ import ara

✗ from ara import setup_callback_plugins

Install, configure callback plugins, run a playbook, and generate a static HTML report.

# Install ara pip install ara ansible # Set the callback plugin path export ANSIBLE_CALLBACK_PLUGINS="$(python -m ara.setup.callback_plugins)" # Run a playbook (results are recorded automatically) ansible-playbook -i inventory playbook.yml # Generate an HTML report ara-manage generate /tmp/ara-report

Debug

Known issues

breakingARA 1.6+ dropped support for Python 2.7 and Ansible <2.9. Upgrade to Python 3.8+ and Ansible 2.9+.

fix

Use Python >=3.8 and Ansible >=2.9.

affects: >=1.6

gotchaARA uses a SQLite database by default. For production, configure a different database (e.g., MySQL or PostgreSQL) to avoid corruption.

fix

Set environment variable ARA_DATABASE_ENGINE and ARA_DATABASE_* accordingly.

affects: all

deprecatedThe `ara` CLI command is deprecated. Use `ara-manage` instead.

fix

Replace `ara generate` with `ara-manage generate`; check help: `ara-manage --help`.

affects: >=1.5

gotchaIf you run multiple Ansible playbooks concurrently with the default SQLite database, you may get `database is locked` errors.

fix

Switch to a server-based database (PostgreSQL/MySQL) or serialize playbook runs.

affects: all

Upgrade

Version history

1.7.5latest on PyPI · released Feb 26, 2026

Audit

Dependencies

ansiblerequiredARA is an Ansible callback plugin; Ansible must be installed.

Agent activity

38 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/ara/ ↗

homepagehttps://codeberg.org/ansible-community/ara ↗