Monitoring: application telemetry in production (OpenTelemetry)

オープン
#2,717 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 3 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
12/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
apache, grafana, prometheus, python

調査の方向性

This is a design issue, not a starter task: the checklist asks for decisions on overhead, trace contents, packaging and the collector setup before code. Read the context in #2716 and the dev prototype in #2484, then look at oeplatform/wsgi.py and podman/monitoring/, the places the issue names for the SDK setup and the new units. Done means the open items are answered in the thread, with overhead measured on a request path.

索引モデルが issue の本文から書いたものです。

説明

deployment Infrastructure type: enhancement :gear:

Part of #2412. A later phase; not needed for the first monitoring version (#2716).

Why

#2716 watches the platform from outside: probes, host, containers, database, usage counts from the access log. It cannot say why a request is slow (which view, which queries). That needs telemetry from inside the application: traces and request metrics.

What is known

  • opentelemetry-instrument cannot instrument production. The production container runs Apache + mod_wsgi; the Python processes are mod_wsgi daemon processes, so a wrapper has nothing to start. The SDK must be set up in oeplatform/wsgi.py, once per daemon process.
  • The dev-side prototype is #2484, reduced to a development tool (see #2663). This issue is the production half.
  • The data path already exists: an OpenTelemetry Collector as another Quadlet unit beside podman/monitoring/, request metrics into the existing Prometheus, traces into Jaeger v2 or Grafana Tempo.

To decide and do

  • Overhead measured on the request path before anything reaches production (it runs on every request).
  • What a trace may contain: URL query strings can carry tokens and must be scrubbed; no user names.
  • Packages pinned in requirements-telemetry.txt; whether the production image installs them, or a build argument switches them on.
  • Collector and trace store as oep-mon-* units, localhost-only like the rest.
  • Relation to the planned slow-request log (one structured line per slow request): traces may replace it, or it comes first because it is cheaper.
主要言語
Python
スター
65
フォーク
28
平均マージ
4日 7時間
マージ済み PR(30日)
25

環境構築

Codespaces で開く

このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

OpenEnergyPlatform/oeplatform のほかの issue

OpenEnergyPlatform/oeplatform の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。