logdag

Overview

This package generates causal DAGs among time-series events in syslog data. This package works on python3. The input log data is loaded with AMULOG (https://github.com/amulog/amulog). The output DAG is recorded in the format of NetworkX DiGraph.

This project was partially forked from repository LogCausalAnalysis. (https://github.com/cpflat/LogCausalAnalysis)

Usage

All features are available from command line. First you should try following help command python -m logdag -h.

short usage:

Generate amulog database (and its config) as the input log time-series source
Prepare logdag config file by referring logdag/data/config.conf.default
Generate time-series db by logdag.source features
Generate DAGs by subcommand makedag
See results by commands such as show-subgraphs

See the wiki for full documentation (installation, quick start, configuration, causal-discovery methods, and CLI reference), and the tutorial directory for a runnable sample.

Reference

This project is evaluated in some papers CNSM2019 and TNSM2018. If you use this code, please consider citing:

@inproceedings{Kobayashi_CNSM2019,
  author = {Kobayashi, Satoru and Otomo, Kazuki and Fukuda, Kensuke},
  booktitle = {Proceedings of the 15th International Conference on Network and Service Management (CNSM'20)},
  title = {Causal analysis of network logs with layered protocols and topology knowledge},
  pages = {1-9},
  year = {2019}
}


@article{Kobayashi_TNSM2018,
  author = {Kobayashi, Satoru and Otomo, Kazuki and Fukuda, Kensuke and Esaki, Hiroshi},
  journal = {IEEE Transactions on Network and Service Management},
  volume = {15},
  number = {1},
  pages = {53-67},
  title = {Mining causes of network events in log data with causal inference},
  year = {2018}
}

License

3-Clause BSD license

Author

Satoru Kobayashi

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

logdag-0.3.2.tar.gz (124.1 kB view details)

Uploaded Aug 5, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

logdag-0.3.2-py3-none-any.whl (103.7 kB view details)

Uploaded Aug 5, 2026 Python 3

File details

Details for the file logdag-0.3.2.tar.gz.

File metadata

Download URL: logdag-0.3.2.tar.gz
Upload date: Aug 5, 2026
Size: 124.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for logdag-0.3.2.tar.gz
Algorithm	Hash digest
SHA256	`8f409c51ecca1455cc69b808353c5388abd248035cc0474a782e3e0650665ab4`
MD5	`6cd0b9a440927f22cfd85cfa99cc8a38`
BLAKE2b-256	`3abd74f7e1694e92820132b21e1cb9edca3a48ed28643064c76e36db07f4234e`

See more details on using hashes here.

Provenance

The following attestation bundles were made for logdag-0.3.2.tar.gz:

Publisher: publish.yml on amulog/logdag

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: logdag-0.3.2.tar.gz
- Subject digest: 8f409c51ecca1455cc69b808353c5388abd248035cc0474a782e3e0650665ab4
- Sigstore transparency entry: 2343838320
- Sigstore integration time: Aug 5, 2026
Source repository:
- Permalink: amulog/logdag@ef21403201472fd0f5e498c5deb5eaf4693d14c0
- Branch / Tag: refs/tags/v0.3.2
- Owner: https://github.com/amulog
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@ef21403201472fd0f5e498c5deb5eaf4693d14c0
- Trigger Event: push