Commit Graph

35 Commits

Author SHA1 Message Date
Vincent Bernat
e47eb35a82 docs: fix path to Akvorado configuration file 2025-09-09 15:22:26 +02:00
Vincent Bernat
291386b057 docs: fix unittest requiring an exact match on documentation 2025-08-26 08:39:48 +02:00
Vincent Bernat
06e3f334fd docs: proofread the whole documentation
Notably, more active voice and simplify a bit.
2025-08-26 08:25:57 +02:00
Vincent Bernat
332435d650 docs: Netflow → NetFlow 2025-07-31 09:13:37 +02:00
Vincent Bernat
fc1028bfcd doc: documentation update for inlet/outlet separation 2025-07-27 21:44:28 +02:00
Vincent Bernat
ac68c5970e inlet: split inlet into new inlet and outlet
This change split the inlet component into a simpler inlet and a new
outlet component. The new inlet component receive flows and put them in
Kafka, unparsed. The outlet component takes them from Kafka and resume
the processing from here (flow parsing, enrichment) and puts them in
ClickHouse.

The main goal is to ensure the inlet does a minimal work to not be late
when processing packets (and restart faster). It also brings some
simplification as the number of knobs to tune everything is reduced: for
inlet, we only need to tune the queue size for UDP, the number of
workers and a few Kafka parameters; for outlet, we need to tune a few
Kafka parameters, the number of workers and a few ClickHouse parameters.

The outlet component features a simple Kafka input component. The core
component becomes just a callback function. There is also a new
ClickHouse component to push data to ClickHouse using the low-level
ch-go library with batch inserts.

This processing has an impact on the internal representation of a
FlowMessage. Previously, it was tailored to dynamically build the
protobuf message to be put in Kafka. Now, it builds the batch request to
be sent to ClickHouse. This makes the FlowMessage structure hides the
content of the next batch request and therefore, it should be reused.
This also changes the way we decode flows as they don't output
FlowMessage anymore, they reuse one that is provided to each worker.

The ClickHouse tables are slightly updated. Instead of using Kafka
engine, the Null engine is used instead.

Fix #1122
2025-07-27 21:44:28 +02:00
Vincent Bernat
c70f3b74bf orchestrator/clickhouse: remove init.sh endpoint
Instead, just map configuration files inside the container. As we don't
have to push the schema anymore, pushing some arbitrary configuration
does not seem to be our job.
2025-07-27 21:44:28 +02:00
Fabian Bees
708889d558 feat/console: option to sort by last column 2025-02-21 10:03:30 +01:00
Vincent Bernat
2df8b5785b console: use avg/max for LimitType (instead of Avg/Max) 2024-11-23 23:48:02 +01:00
dimbdr
6c0e8e1791 feat: configure limit type (#1482)
* Add limit type field selection

* Take into account LimitType to generate SQL request for Line graph

Also, add LimitType in default configuration for console

* Take into account LimitType to generate SQL request for Sankey graph

* Refactor on SQL query used by line and sankey

* Add limitType description in doc

* Order by max in graphLine when limitType max is used

* Fix query when using top max

Revert some modifications, as they were no longer relevant with the query fixed.

* Rework way to sort by max in line graph type

* Add configuration validation on LimitType

---------

Co-authored-by: Dimitri Baudrier <github.52grm@simplelogin.com>
2024-11-23 18:39:28 +01:00
Vincent Bernat
b464a00be1 console: fix %-display when speed of an interface is 0
And add a warning about that in the documentation.
2023-06-22 01:16:06 +02:00
Vincent Bernat
d5cde97891 console: add “%” to available units
This is useful to detect interfaces that are close to saturation
quickly. It would usually require to group by exporter name and
interface name and it may not make sense for some graph types (like
stacked 100%). It is useful with Lines and Grid.
2023-02-09 21:14:36 +01:00
Vincent Bernat
68539505d4 console/frontend: change hint at the top of the filter box 2023-02-07 19:46:27 +01:00
Vincent Bernat
487cf24099 build: remove use of protobuf-compiler
Not needed anymore.
2023-01-19 11:51:25 +01:00
Vincent Bernat
587417b558 console: use =/!= instead of HAS/HASNOT
It seems better to avoid multiplying the symbols to know. While it is
not strictly an equality, we won't use equality for this kind of
columns.
2022-09-28 14:45:08 +02:00
Vincent Bernat
9b821419c3 console: use DstCommunities 2022-09-27 00:34:41 +02:00
Vincent Bernat
bd31b80cc0 console: HAS/HASNOT operator for filtering on ASPath 2022-09-27 00:34:41 +02:00
Vincent Bernat
454a3eb9d3 console: add "previous period" mode
This displays a line for the previous period on stacked graphs.
Previous period depends on the current period. It could be hour, day,
week, month, or year.
2022-08-09 21:40:06 +02:00
Vincent Bernat
684a219fac cmd: replace fake-exporter by demo-exporter
Also propagate this rename to configuration and code. It makes easier
to understand the purpose of such a command in the provided
`docker-compose` file.
2022-07-26 17:42:16 +02:00
Vincent Bernat
489c169fbb console: add <</!<< operator to subnet match for SrcAddr/DstAddr
This does not work for ExporterAddress due to a potential bug in
Clickhouse's isIPAddressInRange when using a LowCardinality type. See
https://github.com/ClickHouse/ClickHouse/issues/39599.
2022-07-26 11:59:30 +02:00
Vincent Bernat
42c794cd97 doc: various updates 2022-07-20 07:49:00 +02:00
Vincent Bernat
2427af6de9 doc: add a few screenshots 2022-07-11 14:07:51 +02:00
Vincent Bernat
635e156292 fakeexporter: add documentation 2022-07-07 21:49:47 +02:00
Vincent Bernat
f67d2493b0 orchestrator: allow to register several configuration for a given service
Use the first one by default and if the index is not known. Remove
service registration as this is not used yet.
2022-06-29 15:45:59 +02:00
Vincent Bernat
bba8fa8c02 doc: also document Y-axis unit 2022-06-24 23:08:28 +02:00
Vincent Bernat
31bdeecdeb doc: update documentation to mention ability to save filters 2022-06-24 23:04:58 +02:00
Vincent Bernat
8ec6492448 orchestrator: remove broker reference from URLs too
The broker component was merged as the root orchestrator component.
Remove references from URL too.
2022-06-20 15:53:14 +02:00
Vincent Bernat
95ab124ddc console/frontend: add linting and autocomplete for filters 2022-05-29 16:29:35 +02:00
Vincent Bernat
4114568600 console/filter: add completion endpoint 2022-05-26 15:58:52 +02:00
Vincent Bernat
a6a13a16ab console/filter: multi-line comments 2022-05-26 08:27:04 +02:00
Vincent Bernat
6b6e1b8fba doc: update with a few words about the console 2022-05-24 22:09:21 +02:00
Vincent Bernat
2fed10c8d2 orchestrator/broker: implement the broker component
Currently, it only exposes the configuration to other components. In
the future, it should be able to interact with them somehow.
2022-04-10 17:43:15 +02:00
Vincent Bernat
93da599adf cmd: take configuration as a mandatory argument (+ other changes)
The other changes are:
 - rename configure service to orchestrator service
 - turn DefaultConfiguration variables into functions
2022-04-10 15:14:39 +02:00
Vincent Bernat
f10e85ee6d doc: fix URLs for configure service 2022-04-07 09:05:47 +02:00
Vincent Bernat
1dc253764d global: split Akvorado into 3 services 2022-04-01 20:21:53 +02:00