ARA - Ansible run analysis
Project description
ARA: Ansible Run Analysis
tl;dr
ARA is an attempt to make Ansible runs easier to visualize, understand and troubleshoot.
ARA is three things:
An Ansible callback plugin to record playbook runs into a local or remote database
A CLI client to query the database
A web interface to visualize the database
Overview
ARA organizes recorded playbook data in a way to make it intuitive for you to search and find what you’re interested for as fast and as easily as possible.
It provides summaries of task results per host or per playbook.
It allows you to filter task results by playbook, play, host, task or by the status of the task.
With ARA, you’re able to easily drill down from the summary view for the results you’re interested in, whether it’s a particular host or a specific task.
Beyond browsing a single ansible-playbook run, ARA supports recording and viewing multiple runs in the same database.
This allows you to, for example, recognize patterns (ex: this particular host is always failing this particular task) since you have access to data from multiple runs.
Installing
Packaged dependencies
RHEL, CentOS, Fedora
yum -y install gcc python-devel libffi-devel openssl-devel
Ubuntu, Debian
apt-get -y install gcc python-dev libffi-dev libssl-dev
From source
git clone https://github.com/dmsimard/ara cd ara pip install .
From pip
pip install ara
What does the web interface look like ?
A video is available on YouTube and the following are screenshots of the web interface:
Documentation
Documentation is available on readthedocs.io.
Contributors and special thanks
See contributors on GitHub.
Special thanks to Lars Kellogg-Stedman for the early feedback on the project, ideas and code contributions.
Copyright
Copyright 2016 Red Hat, Inc.
Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
