recordsansible
/
ara
Code Issues Proposed changes
RETIRED, this project has moved to https://github.com/ansible-community/ara
472 Commits 2 Branches 72 Tags 21 MiB
YAML 100%
Go to file
David Moreau-Simard 50a0fb9fcb Add task files to fake task test resources 
It would otherwise yield tasks without files which shouldn't happen.

Change-Id: Ib49678ae24f3deba4ffd84e01522eb306de0b9b5
 		2017-07-28 12:08:07 -04:00
ara Add task files to fake task test resources 2017-07-28 12:08:07 -04:00
doc/source Provide helpful return output on ara_record tasks 2017-05-25 23:21:38 +00:00
.coveragerc Output the coverage report to cover/ 2016-06-14 14:32:16 -04:00
.gitignore Update .gitignore 2017-07-10 14:57:34 +05:30
.gitreview add .gitreview file for review.openstack.org 2016-06-09 05:13:42 +00:00
LICENSE First commit 2016-05-08 22:45:47 -04:00
README.rst Update the youtube demo URL 2017-05-06 11:45:09 -04:00
bindep.txt Drop tree from development dependencies 2017-02-20 16:08:44 +00:00
requirements.txt Bump minimum version of Ansible to 2.2.0.0 2017-07-23 09:59:05 -04:00
run_tests.sh Bump minimum version of Ansible to 2.2.0.0 2017-07-23 09:59:05 -04:00
setup.cfg Remove the "ara generate" command (replaced by "ara generate html") 2017-04-30 15:41:22 -04:00
setup.py Add missing copyright statements, bump to 2017 2017-02-12 15:51:30 -05:00
test-requirements.txt Fix warning test to allow to unpin pytest 2017-07-18 12:25:50 -04:00
tox.ini Enable some off-by-default checks 2017-07-20 09:21:16 +08:00

README.rst

ARA: Ansible Run Analysis

image

ARA is an open source project that was created by Ansible users for Ansible users.

Its purpose is to provide a way to simply and easily understand what happens throughout playbook runs at any scale.

ARA records Ansible playbook runs and makes the recorded data available and intuitive for users and systems.

TL;DR

ARA records Ansible Playbook runs seamlessly to make them easier to visualize, understand and troubleshoot. It integrates with Ansible wherever you run it.

ARA provides four things:

  1. An Ansible callback plugin to record playbook runs into a local or remote database
  2. The ara_record and ara_read pair of Ansible modules to record and read persistent data with ARA
  3. A CLI client to query the database
  4. A dynamic, database-driven web interface that can also be generated and served from static files

What does the web interface look like ?

A video preview and explanation of the web interface is available on YouTube, featuring playbook runs from the OpenStack-Ansible project.

Otherwise, screenshots highlighting some of ARA's features are available in the frequently asked questions

Community and getting help

The ARA community hangs out on IRC on the freenode network.

Come chat with developers and users on the #ara channel !

Contributing, issues and bugs

Contributions to ARA are definitely welcome and much appreciated !

ARA does not use GitHub for issues or pull requests.

ARA uses the OpenStack infrastructure for code hosting and review as well as project and bug/issue tracking.

The contributor documentation will get you started quickly if you need help contributing !

You might also be interested in reading the project manifesto in order to have a good understanding of the project's core values and philosophy.

Documentation

Frequently asked questions and documentation on how to install, configure, use to ARA is available on readthedocs.io.

Contributors

See contributors on GitHub.

Copyright

Copyright 2017 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.