https://github.com/misp/misp-usage-statistics
MISP usage statistics using bokeh (as a static webpage)
https://github.com/misp/misp-usage-statistics
misp threat-intelligence-platform
Last synced: 12 months ago
JSON representation
MISP usage statistics using bokeh (as a static webpage)
- Host: GitHub
- URL: https://github.com/misp/misp-usage-statistics
- Owner: MISP
- License: bsd-2-clause
- Created: 2022-03-30T12:43:20.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2022-03-30T14:25:54.000Z (about 4 years ago)
- Last Synced: 2025-05-08T01:34:25.647Z (about 1 year ago)
- Topics: misp, threat-intelligence-platform
- Language: Python
- Homepage:
- Size: 3.3 MB
- Stars: 3
- Watchers: 6
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# MISP Usage statistics
MISP Usage statistic is a Python software to generate static pages using [Bokeh](https://github.com/bokeh/bokeh) from a [MISP](https://www.misp-project.org/) instance.
You can see the result in the [operational statistics of CIRCL](https://circl.lu/opendata/statistics/#usage-of-misp-offered-as-a-service-by-circl-misppriv-circl-lu).
# Installation
```bash
cp config.py.sample config.py
python3 -m venv venv
source venv/bin/activate
pip3 install -r requirements.txt
```
Update the geo location data base:
- Download the database [here](https://data.public.lu/fr/datasets/geo-open-ip-address-geolocation-per-country-in-mmdb-format/)
- save it in the `geolocation` folder
- Don't forget to update `config.py`
# Requirements
- Python >=3.8
- [Bokeh library](https://github.com/bokeh/bokeh)
- [MMDB GeoOpen database](https://data.public.lu/fr/datasets/geo-open-ip-address-geolocation-per-country-in-mmdb-format/)
# Usage
- Activate environment `source venv/bin/activate`
- Review `config.py` and adapt paths accordingly
- Generate the statistics with the `generate_misp.py` script
- Generate the charts via the `plot_misp.py` script
- `package_data.sh` creates an archive containing the JSON files
**TL;DR**: The whole procedure can be done by calling the `RUN-ME.sh` script:
```bash
bash RUN-ME.sh
```
## Result of running the command above:
- A JSON containing the aggregated data is written in `data/misp/data-misp.json`
- An HTML file containing the chart is written in `html/misp/plot-bokeh-misp.html`
- An archive containing the aggregated data is written in `exposed/data.tar.gz`
## License
This software is an open source software [released under a 2-Clause BSD license](./LICENSE.md).