Skip to content

Document Grafana Alloy integration#149

Open
balanza wants to merge 5 commits intomainfrom
prometheus-push
Open

Document Grafana Alloy integration#149
balanza wants to merge 5 commits intomainfrom
prometheus-push

Conversation

@balanza
Copy link
Copy Markdown
Member

@balanza balanza commented Feb 6, 2026

integrate user documentation to use Prometheus with Grafana Alloy

  • what changes for the Trento Agent
  • how to configure Prometheus
  • enable Alloy configuration

@balanza balanza requested review from EMaksy and abravosuse February 6, 2026 12:20
Copy link
Copy Markdown
Collaborator

@abravosuse abravosuse left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Awesome job, @balanza . Just a couple of clarification requests and one note-to-self.

Comment thread trento/adoc/trento-integration-prometheus.adoc Outdated
Comment thread trento/adoc/trento-integration-prometheus.adoc Outdated
Comment thread trento/adoc/trento-integration-prometheus.adoc Outdated
Copy link
Copy Markdown
Collaborator

@abravosuse abravosuse left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you @balanza . A few change requests (related to the fact that basic is now the default authentication method) and a couple of questions/suggestions.

Comment thread trento/adoc/trento-install-agents.adoc Outdated
== {prometheus} integration

{prometheus} Server is a {trserver} component responsible for retrieving the memory and CPU utilization metrics collected by the `node-exporter` in the agent hosts and serving them to the web component. The web component renders the metrics as dynamic graphical charts in the details view of the registered hosts.
{prometheus} Server is a {trserver} component responsible for retrieving the memory and CPU utilization metrics from the agent hosts and serving them to the web component. The web component renders the metrics as dynamic graphical charts in the details view of the registered hosts.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note to self to remember to update this paragraph when filesystem/swap utilization metrics are displayed in the UI. Also when metrics are exposed to MCP.

Comment thread trento/adoc/trento-integration-prometheus.adoc Outdated
Comment thread trento/adoc/trento-integration-prometheus.adoc Outdated
Comment thread trento/adoc/trento-integration-prometheus.adoc
Comment thread trento/adoc/trento-integration-prometheus.adoc Outdated
Copy link
Copy Markdown
Member

@EMaksy EMaksy left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @balanza technicly the document can be merged, on the content nothing bit my eye :)
Clear the rest with @abravosuse and we should be fine to merge :)

Copy link
Copy Markdown
Collaborator

@abravosuse abravosuse left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@balanza explaining how to start prometheus with the --web.enable-remote-write-receiver flag in a sysconfig file scenario (which is what the user will have if they have followed our steps to install prometheus).

===== Enable the {prometheus} remote write receiver

{trento} supports basic authentication, bearer token, and mutual TLS (mTLS) on the agent side. Configure your reverse proxy to validate credentials using the method of your choice.
{prometheus} must be started with the `--web.enable-remote-write-receiver` flag. How to set this flag depends on how {prometheus} is managed on your platform (for example, via a sysconfig file, a systemd drop-in, or a command-line argument).
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If the user has followed our manual steps to install Prometheus, it will be a sysconfig file scenario. I suggest we explain how to do it in that case. Something like the following:

{prometheus} must be started with the --web.enable-remote-write-receiver flag. How to set this flag depends on how {prometheus} is managed on your platform (for example, via a sysconfig file, a {systemd} drop-in, or a command-line argument). In a sysconfig file scenario, add ARGS="--web.enable-remote-write-receiver" to the /etc/sysconfig/prometheus configuration file.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

3 participants