nDPId/examples
Toni Uhlig 36e428fc89
Sync unit tests.
Signed-off-by: Toni Uhlig <matzeton@googlemail.com>
2022-11-13 16:19:07 +01:00
..
c-analysed nDPIsrvd.h: Provide two additional convenient API functions. 2022-11-06 13:19:29 +01:00
c-captured Sync unit tests. 2022-11-13 16:19:07 +01:00
c-collectd Improved nDPIsrvd-collectd statistics. 2022-10-31 12:45:15 +01:00
c-json-stdout Build JSMN with support for parent links. 2021-07-13 03:35:35 +02:00
c-simple Refactored client distributor C API. 2022-09-25 00:54:39 +02:00
js-rt-analyzer@124595114f nDPid-test: add buffer test 2022-10-30 20:12:17 +01:00
py-flow-dashboard nDPId: Reduced flow-updates for TCP flows to 1/4 of the timeout value. 2022-09-19 19:39:49 +02:00
py-flow-info bump libnDPI to db9f6ec1b4018164e5bff05f115dc60711bb711b 2022-10-31 13:53:02 +01:00
py-flow-muliprocess nDPId: Reduced flow-updates for TCP flows to 1/4 of the timeout value. 2022-09-19 19:39:49 +02:00
py-json-stdout nDPId: Reduced flow-updates for TCP flows to 1/4 of the timeout value. 2022-09-19 19:39:49 +02:00
py-machine-learning py-machine-learning: load and save trained models 2022-10-15 11:59:39 +02:00
py-schema-validation nDPId: Reduced flow-updates for TCP flows to 1/4 of the timeout value. 2022-09-19 19:39:49 +02:00
py-semantic-validation nDPId: Reduced flow-updates for TCP flows to 1/4 of the timeout value. 2022-09-19 19:39:49 +02:00
ndpid_install_and_run.gif Improve README 2022-08-12 11:10:45 +02:00
README.md Increased network buffer size to 33792 bytes. 2022-10-30 22:13:07 +01:00

examples

Some ready-2-use/ready-2-extend examples/utils. All examples are prefixed with their used LANG.

c-analysed

A feature extractor useful for ML/DL use cases. It generates CSV files from flow "analyse" events.

c-captured

A capture daemon suitable for low-resource devices. It saves flows that were guessed/undetected/risky/midstream to a PCAP file for manual analysis.

c-collectd

A collecd-exec compatible middleware that gathers statistic values from nDPId.

c-json-stdout

Tiny nDPId json dumper. Does not provide any useful funcationality besides dumping parsed JSON objects.

c-simple

Very tiny integration example.

js-rt-analyzer

nDPId-rt-analyzer

py-flow-info

Prints prettyfied information about flow events.

py-machine-learning

Use sklearn together with CSVs created with c-analysed to train and predict DPI detections.

Try it with: ./examples/py-machine-learning/sklearn_random_forest.py --csv ./ndpi-analysed.csv --proto-class tls.youtube --proto-class tls.github --proto-class tls.spotify --proto-class tls.facebook --proto-class tls.instagram --proto-class tls.doh_dot --proto-class quic --proto-class icmp

This way you should get 9 different classification classes. You may notice that some classes e.g. TLS protocol classifications may have a higher false-negative rate. Unfortunately, I can not provide any datasets due to some privacy concerns. But you can use a pre-trained model with --load-model and the aformentioned parameters.

py-flow-dashboard

A realtime web based graph using Plotly/Dash. Probably the most informative example.

py-flow-multiprocess

Simple Python Multiprocess example spawning two worker processes, one connecting to nDPIsrvd and one printing flow id's to STDOUT.

py-json-stdout

Dump received and parsed JSON strings.

py-schema-validation

Validate nDPId JSON strings against pre-defined JSON schema's. See schema/. Required by tests/run_tests.sh

py-semantic-validation

Validate nDPId JSON strings against internal event semantics. Required by tests/run_tests.sh