# Armada
[![PyPI - Version](https://img.shields.io/pypi/v/armada-logs?label=pypi%20package&color=blue)](https://github.com/Viter-0/armada)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/armada-logs?color=blue)](https://github.com/Viter-0/armada)
Armada is a lightweight tool designed for centralized network log viewing across multiple data sources. It provides quick and detailed insights into network flows enriched with metadata.
Originally created to analyze VMware NSX logs, its broader goal is to become a versatile tool for general network log analysis.
## Features
- Simple setup process. There is no need for complex configurations or additional servers;
- Search query suggestions and autocompletion;
- Log correlation with relevant asset data;
- Current Data Source Support:
- VMware Aria Operations for Logs
- VMware Aria Operations for Networks
- Ivanti Neurons (HEAT) for ITSM
- IBM QRadar
## Screenshots
## Demo Access
You can explore Armada by accessing our demo environment. Please wait for the demo environment to start.
URL: [Demo](https://armada-pida.onrender.com/)
Login Credentials:
- Username: `demo@demo.lan`
- Password: `demo`
## Getting Started
Use pip to install Armada:
```console
pip install armada-logs
```
Run the application to launch the web server.
```console
armada run prod
```
Open the web interface in your browser. By default, it will start on <http://localhost:8000>
Create an initial user account.
Add at least one data source to start collecting logs and assets.
## Roadmap
Armada is continuously evolving with new features and integrations. Below are some of the planned enhancements. Have ideas or feature requests? Feel free to contribute or open an issue!
New Data Sources
- Palo Alto Firewall
- FortiGate Firewall
- Switches and Routers: Cisco, Fortinet, Aruba, Juniper
- Network Access Control (NAC): Cisco ISE, Aruba ClearPass
New Features
- Ability to view UTM logs such as Antivirus, Web-filter and IPS;
- Support for ARP and Security Groups as new asset types;
- Enhance asset data with user-defined attributes for more flexibility;
- Query data sources using user-defined attributes;
## Contributing
If you want to suggest features, report bugs, or contribute code, don't hesitate to reach out or create an issue.
Raw data
{
"_id": null,
"home_page": "https://github.com/Viter-0/armada",
"name": "armada-logs",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "log-analysis, vmware, nsx, logging, network, flows, firewall",
"author": "Viter",
"author_email": "viterr@proton.me",
"download_url": "https://files.pythonhosted.org/packages/fa/0a/c3af48ece7878ccabff7526855bd1eb254edf0926d97e5e409c67e57266b/armada_logs-0.1.1.tar.gz",
"platform": null,
"description": "# Armada\n\n[![PyPI - Version](https://img.shields.io/pypi/v/armada-logs?label=pypi%20package&color=blue)](https://github.com/Viter-0/armada)\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/armada-logs?color=blue)](https://github.com/Viter-0/armada)\n\nArmada is a lightweight tool designed for centralized network log viewing across multiple data sources. It provides quick and detailed insights into network flows enriched with metadata.\n\nOriginally created to analyze VMware NSX logs, its broader goal is to become a versatile tool for general network log analysis.\n\n## Features\n\n- Simple setup process. There is no need for complex configurations or additional servers;\n- Search query suggestions and autocompletion;\n- Log correlation with relevant asset data;\n- Current Data Source Support:\n - VMware Aria Operations for Logs\n - VMware Aria Operations for Networks\n - Ivanti Neurons (HEAT) for ITSM\n - IBM QRadar\n\n## Screenshots\n\n## Demo Access\n\nYou can explore Armada by accessing our demo environment. Please wait for the demo environment to start.\n\nURL: [Demo](https://armada-pida.onrender.com/)\n\nLogin Credentials:\n\n- Username: `demo@demo.lan`\n\n- Password: `demo`\n\n## Getting Started\n\nUse pip to install Armada:\n\n```console\npip install armada-logs\n```\n\nRun the application to launch the web server.\n\n```console\narmada run prod\n```\n\nOpen the web interface in your browser. By default, it will start on <http://localhost:8000>\n\nCreate an initial user account.\n\nAdd at least one data source to start collecting logs and assets.\n\n## Roadmap\n\nArmada is continuously evolving with new features and integrations. Below are some of the planned enhancements. Have ideas or feature requests? Feel free to contribute or open an issue!\n\nNew Data Sources\n\n- Palo Alto Firewall\n- FortiGate Firewall\n- Switches and Routers: Cisco, Fortinet, Aruba, Juniper\n- Network Access Control (NAC): Cisco ISE, Aruba ClearPass\n\nNew Features\n\n- Ability to view UTM logs such as Antivirus, Web-filter and IPS;\n- Support for ARP and Security Groups as new asset types;\n- Enhance asset data with user-defined attributes for more flexibility;\n- Query data sources using user-defined attributes;\n\n## Contributing\n\nIf you want to suggest features, report bugs, or contribute code, don't hesitate to reach out or create an issue.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Armada provides quick and detailed insights into network flows enriched with metadata",
"version": "0.1.1",
"project_urls": {
"Bug Tracker": "https://github.com/Viter-0/armada/issues",
"Homepage": "https://github.com/Viter-0/armada",
"Repository": "https://github.com/Viter-0/armada"
},
"split_keywords": [
"log-analysis",
" vmware",
" nsx",
" logging",
" network",
" flows",
" firewall"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "07a7030542a3639870609e4776769dc50305a3f0f9fa2e60485ab2fad6ac8f32",
"md5": "87b972fdd6b3903802972a34b4c68667",
"sha256": "a5e96d275ffb2a589deacf439148445d2c9c5f62a33f88a84e8d8742d7972d09"
},
"downloads": -1,
"filename": "armada_logs-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "87b972fdd6b3903802972a34b4c68667",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 1185380,
"upload_time": "2025-01-12T15:33:54",
"upload_time_iso_8601": "2025-01-12T15:33:54.409254Z",
"url": "https://files.pythonhosted.org/packages/07/a7/030542a3639870609e4776769dc50305a3f0f9fa2e60485ab2fad6ac8f32/armada_logs-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fa0ac3af48ece7878ccabff7526855bd1eb254edf0926d97e5e409c67e57266b",
"md5": "b41852ed18b1f406659c74d42828f253",
"sha256": "a9dd74489fbada538efeee705f110df75efd2d27af4e4f0940290c2d77393133"
},
"downloads": -1,
"filename": "armada_logs-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "b41852ed18b1f406659c74d42828f253",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 89278,
"upload_time": "2025-01-12T15:33:56",
"upload_time_iso_8601": "2025-01-12T15:33:56.910990Z",
"url": "https://files.pythonhosted.org/packages/fa/0a/c3af48ece7878ccabff7526855bd1eb254edf0926d97e5e409c67e57266b/armada_logs-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-12 15:33:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Viter-0",
"github_project": "armada",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "armada-logs"
}