.config
.github
LICENSES
bin
collections
docs
examples
group_vars
i18n
bin
locales
translation-templates
docs
README.pot
alternative-architectures.pot
ansible.pot
configuring-captcha.pot
configuring-dns.pot
configuring-playbook-alertmanager-receiver.pot
configuring-playbook-appservice-double-puppet.pot
configuring-playbook-appservice-draupnir-for-all.pot
configuring-playbook-backup-borg.pot
configuring-playbook-base-domain-serving.pot
configuring-playbook-bot-baibot.pot
configuring-playbook-bot-buscarron.pot
configuring-playbook-bot-chatgpt.pot
configuring-playbook-bot-draupnir.pot
configuring-playbook-bot-go-neb.pot
configuring-playbook-bot-honoroit.pot
configuring-playbook-bot-matrix-registration-bot.pot
configuring-playbook-bot-matrix-reminder-bot.pot
configuring-playbook-bot-maubot.pot
configuring-playbook-bot-mjolnir.pot
configuring-playbook-bridge-appservice-discord.pot
configuring-playbook-bridge-appservice-irc.pot
configuring-playbook-bridge-appservice-kakaotalk.pot
configuring-playbook-bridge-appservice-slack.pot
configuring-playbook-bridge-appservice-webhooks.pot
configuring-playbook-bridge-beeper-linkedin.pot
configuring-playbook-bridge-go-skype-bridge.pot
configuring-playbook-bridge-heisenbridge.pot
configuring-playbook-bridge-hookshot.pot
configuring-playbook-bridge-matrix-bridge-sms.pot
configuring-playbook-bridge-mautrix-bridges.pot
configuring-playbook-bridge-mautrix-discord.pot
configuring-playbook-bridge-mautrix-facebook.pot
configuring-playbook-bridge-mautrix-gmessages.pot
configuring-playbook-bridge-mautrix-googlechat.pot
configuring-playbook-bridge-mautrix-hangouts.pot
configuring-playbook-bridge-mautrix-instagram.pot
configuring-playbook-bridge-mautrix-meta-instagram.pot
configuring-playbook-bridge-mautrix-meta-messenger.pot
configuring-playbook-bridge-mautrix-signal.pot
configuring-playbook-bridge-mautrix-slack.pot
configuring-playbook-bridge-mautrix-telegram.pot
configuring-playbook-bridge-mautrix-twitter.pot
configuring-playbook-bridge-mautrix-whatsapp.pot
configuring-playbook-bridge-mautrix-wsproxy.pot
configuring-playbook-bridge-mx-puppet-discord.pot
configuring-playbook-bridge-mx-puppet-groupme.pot
configuring-playbook-bridge-mx-puppet-instagram.pot
configuring-playbook-bridge-mx-puppet-skype.pot
configuring-playbook-bridge-mx-puppet-slack.pot
configuring-playbook-bridge-mx-puppet-steam.pot
configuring-playbook-bridge-mx-puppet-twitter.pot
configuring-playbook-bridge-postmoogle.pot
configuring-playbook-bridge-wechat.pot
configuring-playbook-cactus-comments.pot
configuring-playbook-client-cinny.pot
configuring-playbook-client-element-web.pot
configuring-playbook-client-hydrogen.pot
configuring-playbook-client-schildichat-web.pot
configuring-playbook-conduit.pot
configuring-playbook-conduwuit.pot
configuring-playbook-dendrite.pot
configuring-playbook-dimension.pot
configuring-playbook-dynamic-dns.pot
configuring-playbook-email.pot
configuring-playbook-email2matrix.pot
configuring-playbook-etherpad.pot
configuring-playbook-external-postgres.pot
configuring-playbook-federation.pot
configuring-playbook-jitsi.pot
configuring-playbook-ldap-auth.pot
configuring-playbook-ma1sd.pot
configuring-playbook-matrix-authentication-service.pot
configuring-playbook-matrix-corporal.pot
configuring-playbook-matrix-ldap-registration-proxy.pot
configuring-playbook-matrix-media-repo.pot
configuring-playbook-matrix-registration.pot
configuring-playbook-mautrix-bridges.pot
configuring-playbook-nginx.pot
configuring-playbook-ntfy.pot
configuring-playbook-own-webserver.pot
configuring-playbook-pantalaimon.pot
configuring-playbook-postgres-backup.pot
configuring-playbook-prometheus-grafana.pot
configuring-playbook-prometheus-nginxlog.pot
configuring-playbook-prometheus-postgres.pot
configuring-playbook-rageshake.pot
configuring-playbook-rest-auth.pot
configuring-playbook-riot-web.pot
configuring-playbook-s3-goofys.pot
configuring-playbook-s3.pot
configuring-playbook-shared-secret-auth.pot
configuring-playbook-sliding-sync-proxy.pot
configuring-playbook-ssl-certificates.pot
configuring-playbook-sygnal.pot
configuring-playbook-synapse-admin.pot
configuring-playbook-synapse-auto-accept-invite.pot
configuring-playbook-synapse-auto-compressor.pot
configuring-playbook-synapse-s3-storage-provider.pot
configuring-playbook-synapse-simple-antispam.pot
configuring-playbook-synapse-usage-exporter.pot
configuring-playbook-synapse.pot
configuring-playbook-telemetry.pot
configuring-playbook-traefik.pot
configuring-playbook-turn.pot
configuring-playbook-user-verification-service.pot
configuring-playbook.pot
configuring-well-known.pot
container-images.pot
faq.pot
getting-the-playbook.pot
howto-server-delegation.pot
howto-srv-server-delegation.pot
importing-postgres.pot
importing-synapse-media-store.pot
importing-synapse-sqlite.pot
installing.pot
just.pot
maintenance-and-troubleshooting.pot
maintenance-checking-services.pot
maintenance-migrating.pot
maintenance-postgres.pot
maintenance-synapse.pot
maintenance-upgrading-services.pot
obtaining-access-tokens.pot
playbook-tags.pot
prerequisites.pot
quick-start.pot
registering-users.pot
self-building.pot
uninstalling.pot
updating-users-passwords.pot
i18n
CHANGELOG.pot
README.pot
YEAR-IN-REVIEW.pot
.gitignore
PUBLISHED_LANGUAGES
README.md
justfile
requirements.txt
roles
.editorconfig
.envrc
.gitattributes
.gitignore
.yamllint
CHANGELOG.md
CHANGELOG.md.license
LICENSE
Makefile
README.md
README.md.license
REUSE.toml
YEAR-IN-REVIEW.md
ansible.cfg
conf.py
flake.lock
flake.nix
jitsi_jvb.yml
justfile
requirements.yml
setup.yml
setup.yml.license
110 lines
6.2 KiB
Plaintext
110 lines
6.2 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2018-2025, Slavi Pantaleev, Aine Etke, MDAD community members
|
|
# This file is distributed under the same license as the matrix-docker-ansible-deploy package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: matrix-docker-ansible-deploy \n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2025-01-27 09:54+0200\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:1
|
|
msgid "Enabling metrics and graphs for NginX logs (optional)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:3
|
|
msgid "It can be useful to have some (visual) insight into [nginx](https://nginx.org/) logs."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:5
|
|
msgid "This adds [prometheus-nginxlog-exporter](https://github.com/martin-helmich/prometheus-nginxlog-exporter/) to your Matrix deployment."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:7
|
|
msgid "It will collect access logs from various nginx reverse-proxies which may be used internally (e.g. `matrix-synapse-reverse-proxy-companion`, if Synapse workers are enabled) and will make them available at a Prometheus-compatible `/metrics` endpoint."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:9
|
|
msgid "**Note**: nginx is only used internally by this Ansible playbook. With Traefik being our default reverse-proxy, collecting nginx metrics is less relevant."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:11
|
|
msgid "To make use of this, you need to install [Prometheus](./configuring-playbook-prometheus-grafana.md) either via the playbook or externally. When using an external Prometheus, configuration adjustments are necessary — see [Save metrics on an external Prometheus server](#save-metrics-on-an-external-prometheus-server)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:13
|
|
msgid "If your setup includes [Grafana](./configuring-playbook-prometheus-grafana.md), a dedicated `NGINX PROXY` Grafana dashboard will be created."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:15
|
|
msgid "Adjusting the playbook configuration"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:17
|
|
msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:23
|
|
msgid "Installing"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:25
|
|
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:32
|
|
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:34
|
|
msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note these shortcuts run the `ensure-matrix-users-created` tag too."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:36
|
|
msgid "Docker Image Compatibility"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:38
|
|
msgid "At the moment of writing only images for `amd64` and `arm64` architectures are available. The playbook currently does not support [self-building](./self-building.md) a container image on other architectures. You can however use a custom-build image by setting:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:45
|
|
msgid "Security and privacy"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:47
|
|
msgid "Metrics and resulting graphs can contain a lot of information. NginX logs contain information like IP address, URLs, UserAgents and more. This information can reveal usage patterns and could be considered Personally Identifiable Information (PII). Think about this before enabling (anonymous) access. Please make sure you change the default Grafana password."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:49
|
|
msgid "Save metrics on an external Prometheus server"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:51
|
|
msgid "The playbook will automatically integrate the metrics into the [Prometheus](./configuring-playbook-prometheus-grafana.md) server provided with this playbook (if enabled). In such cases, the metrics endpoint is not exposed publicly — it's only available on the container network."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:53
|
|
msgid "When using an external Prometheus server, you'll need to expose metrics publicly. See [Collecting metrics to an external Prometheus server](./configuring-playbook-prometheus-grafana.md#collecting-metrics-to-an-external-prometheus-server)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:55
|
|
msgid "You can either use `matrix_prometheus_nginxlog_exporter_metrics_proxying_enabled: true` to expose just this one service, or `matrix_metrics_exposure_enabled: true` to expose all services."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:57
|
|
msgid "Whichever way you go with, this service will expose its metrics endpoint **without password-protection** at `https://matrix.example.com/metrics/nginxlog` by default."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:59
|
|
msgid "For password-protection, use (`matrix_metrics_exposure_http_basic_auth_enabled` and `matrix_metrics_exposure_http_basic_auth_users`) or (`matrix_prometheus_nginxlog_exporter_container_labels_metrics_middleware_basic_auth_enabled` and `matrix_prometheus_nginxlog_exporter_container_labels_metrics_middleware_basic_auth_users`)."
|
|
msgstr ""
|