# SOME DESCRIPTIVE TITLE. # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community # members # This file is distributed under the same license as the # matrix-docker-ansible-deploy package. # FIRST AUTHOR , 2024. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-12-16 12:05+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" "Language-Team: jp \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.16.0\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 "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 ""