Insights Core is a data collection and analysis framework that is built for extensibility and rapid development. Included are a set of reusable components for gathering data in myriad ways and providing a reliable object model for commonly useful unstructured and semi-structured data.
>>> from insights import load_default_plugins, run
>>> from insights.parsers import installed_rpms as rpm
>>> lower = rpm.Rpm("bash-4.4.11-1.fc26")
>>> upper = rpm.Rpm("bash-4.4.22-1.fc26")
>>> load_default_plugins()
>>> results = run(rpm.Installed)
>>> rpms = results[rpm.Installed]
>>> rpms.newest("bash")
0:bash-4.4.12-7.fc26
>>> lower <= rpms.newest("bash") < upper
TrueFeatures
Over 200 Enterprise Linux data parsers
Support for Python 2.7+ and 3.3+
Built in support for local host collection
Data collection support for several archive formats
Installation
Releases can be installed via pip
$ pip install insights-coreDocumentation
There are several resources for digging into the details of how to use insights-core:
The insights-core-tutorials project docs have three tutorials plus instructions on how to setup the tutorial environment
The basic architectural principles of insights-core can be found in the Insights Core tutorial jupyter notebook
A simple stand_alone.py script encapsulates creating all the basic components in a single script that can be easily executed locally
Some quick-start examples are provided in the examples directory. Each subdirectory under examples includes a README.md file that provides a description of the contents and usage information.
To Run the Jupyter Notebooks
If you would like to execute the jupyter notebooks locally, you can install jupyter:
pip install jupyterTo start the notebook server:
jupyter notebookThis should start a web-server and open a tab on your browser. From there, you can navigate to docs/notebooks and select a notebook of interest.
Motivation
Almost everyone who deals with diagnostic files and archives such as sosreports or JBoss server.log files eventually automates the process of rummaging around inside them. Usually, the automation is comprised of fairly simple scripts, but as these scripts get reused and shared, their complexity grows and a more sophisticated design becomes worthwhile.
A general process one might consider is:
Collect some unstructured data (e.g. from a command, an archive, a directory, directly from a system)
Convert the unstructured data into objects with standard APIs.
Optionally combine some of the objects to provide a higher level interface than they provide individually (maybe all the networking components go together to provide a high level API, or maybe multiple individual objects provide the same information. Maybe the same information can be gotten from multiple sources, not all of which are available at the same time from a given system or archive).
Use the data model above at any granularity to write rules that formalize support knowledge, persisters that build database tables, metadata components that extract contextual info for other systems, and more.
Insights Core provides this functionality. It is an extensible framework for collecting and analyzing data on systems, from archives, directories, etc. in a standard way.
Insights Core versus Red Hat Insights
A common confusion about this project is how it relates to Red Hat Insights. Red Hat Insights is a product produced by Red Hat for automated discovery and remediation of issues in Red Hat products. The insights-core project is used by Red Hat Insights, but only represents the data collection and rule analysis infrastructure. This infrastructure is meant to be reusable by other projects.
So, insights-core can be used for individuals wanting to perform analysis locally, or integrated into other diagnostics systems. Parsers or rules written using insights-core can be executed in Red Hat Insights, but, it is not a requirement.
14 maintainers
Release files for insights-core 3.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| insights_core-3.8.1.tar.gz | 2.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| insights_core-3.8.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.5 MB
Release files / insights_core-3.8.1.tar.gz
| Download URL | insights_core-3.8.1.tar.gz |
|---|---|
| Size | 2.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cdc9c891e8e7157c7b2da2e2f656a6e0eb57d17d97c6f8dd7c6da751c647bbdd
|
|
BLAKE2b-256 checksum How to use checksums |
963e517503d5ecccf52bd451a86ed66c25ef434ac117f2cd31e8371868d93ad9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.13
|
Release files / insights_core-3.8.1-py3-none-any.whl
| Download URL | insights_core-3.8.1-py3-none-any.whl |
|---|---|
| Size | 2.6 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
493a3b85135bb5ab25eaeb84b4a87cd7a3810a3a05401940d541c8b2936f4e0e
|
|
BLAKE2b-256 checksum How to use checksums |
6a7e5c61c25ab875c8654f058d17bfb427ced6125933ec7cb70347d3695f706d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.13
|
