Skip to content

shirou/ara

 
 

Repository files navigation

ARA: Ansible Run Analysis

tl;dr

ARA is an attempt to make Ansible runs easier to visualize, understand and troubleshoot.

ARA is three things:

  1. An Ansible callback plugin to record playbook runs into a local or remote database
  2. A CLI client to query the database
  3. 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:

image

image

Documentation

Documentation is available on readthedocs.io.

Discussing ARA

We hang out in #ara on freenode IRC. Come chat with us !

Contributors

See contributors on GitHub.

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

http://www.apache.org/licenses/LICENSE-2.0

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.

About

ARA - Ansible Run Analysis

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 80.9%
  • HTML 17.7%
  • CSS 1.3%
  • Shell 0.1%