content-sync - KNW-2200 translation started, pick-25

Author: thomaskoslowski

src/common/de/opentelemetry.asciidoc

@@ -13,8 +13,6 @@ xref:dcd#[Dynamische Host-Verwaltung]
 {related-end}
 
 
-// TK: Ich hab Dynamic Configuration Daemon durch dynamische Host-Verwaltung ersetzt. DCD wollen wir nicht mehr verwenden, weil es auch in der GUI nicht mehr vorkommt.
-
 [#intro]
 == Einleitung
 
@@ -88,27 +86,7 @@ Sie können diese auf Filterung oder Begrenzung der Sendeintervalle erweitern.
 Hierbei hilft Ihnen die Dokumentation zu link:https://opentelemetry.io/docs/collector/transforming-telemetry/[_Transforming telemetry_^] des OpenTelemetry-Projekts.
 
 .Der Assistent fragt relevante Optionen ab und konfiguriert benötigte Komponenten automatisch mit sinnvollen Standardeinstellungen.
-image::opentelemetry_quick_setup_onprem.png[alt="Der OTel-Einrichtungsassistent mit geöffnetem Schritt der Konfiguration des GRPC-Receivers."]
-
-////
-Für die Erstellung der Hosts mittels dynamischer Host-Verwaltung wird immer der bei den Metriken mitgesendete _Servicename_ verwendet.
-Die Änderung der Konfiguration ist nur nachträglich möglich.
-Über [.guihint]#Setup > Open Telemetry Quick Setup# haben Sie die Möglichkeit, per Knopf zur Konfiguration von Kollektor und dynamischer Host-Verwaltung zu springen.
-// TK: Wörterbuch: Do never use in German: Schaltfläche ;-)
-Alternativ können Sie beide Komponenten nachträglich anpassen, wie im folgenden Abschnitt zur xref:setup_manual[manuellen Einrichtung] beschrieben (xref:collector_configuration[OpenTelemetry Collector] und xref:dcd[dynamische Host-Verwaltung]).
-// TK: Das Linkziel collector_configuration gibt es nicht (mehr) in der saas.
-// TK: Der Absatz lässt mich recht ratlos zurück:
-// TK: Du steigst mit _Servicename_ ein: Ist das nicht ein Detail, das man am Ende auch noch erwähnen kann?
-// TK: Die Änderung der Konfiguration ist nur nachträglich möglich: Und wie geht das?
-// TK: haben Sie die Möglichkeit, per Knopf zur Konfiguration von Kollektor ... zu springen: Da sind wir doch gerade und das zeigt doch der Screenshot. Quick Setup ist doch für die Kollektor-Konfiguration da: Wie und warum soll ich da per Knopf hinspringen?
-// TK: haben Sie die Möglichkeit, per Knopf zur Konfiguration von ... dynamischer Host-Verwaltung zu springen: Den Knopf seh ich aber nicht, oder? Und komm ich nach dem Absprung wieder zurück?
-// TK: Alternativ können Sie beide Komponenten nachträglich anpassen: Das heißt nachträgliche Anpassung ist nur manuell möglich, nicht mehr über den Assistent? Das war bei den anderen Quick Setups aber anders...
-// TK: Zusammenfassung: Erst den Standardfall und dann all die Dinge die man nachträglich anfassen kann/muss und wie man das macht.
-
-xref:custom_graphs[Benutzerdefinierte Graphen] und xref:special_agent_option[Custom Metrics], um via OpenTelemetry empfangene Metriken beliebigen Hosts zuordnen zu können, sind nicht Bestandteil des Assistenten.
-// TK: zu Custom Metrics: Siehe auch die Kommentare weiter unten.
-Diese müssen manuell konfiguriert werden.
-////
+image::opentelemetry_quick_setup_onprem.png[alt="Der OpenTelemetry-Einrichtungsassistent mit geöffnetem Schritt zur Konfiguration des GRPC-Receivers."]
 
 Wenn Sie nach abgeschlossener Ersteinrichtung [.guihint]#Setup > Open Telemetry Quick Setup#
 ifdef::onprem[]
@@ -285,7 +263,7 @@ Aus diesem Grund ist es wichtig, sich bei jedem Anwendungsfall für die passende
 * Die xref:custom_graphs[benutzerdefinierten Graphen] (_custom graphs_) visualisieren Daten auf direktem Weg aus dem Metrik-Backend in Dashboards – ohne Umweg über Services und sogar ohne Beteiligung des Monitoring-Kerns.
 Aus benutzerdefinierten Graphen können Sie direkt Regeln für den im folgenden Punkt vorgestellten Spezialagenten erstellen.
 
-* Die Verwendung xref:special_agent_option[benutzerdefinierter Metriken] (über die Erstellung von _custom queries_) ist dann sinnvoll, wenn Sie einige per OpenTelemetry empfangene Datenpunkte vorhandenen oder extra angelegten Hosts zuordnen wollen.
+* Die Verwendung von xref:special_agent_option[Custom Metrics] (über die Erstellung von _custom queries_) ist dann sinnvoll, wenn Sie einige per OpenTelemetry empfangene Datenpunkte vorhandenen oder extra angelegten Hosts zuordnen wollen.
 Dies schafft die Möglichkeit, Daten aus unterschiedlichen Quellen den Hosts zuzuordnen, zu denen sie organisatorisch oder technisch gehören.
 Der Overhead dieser Methode ist etwas höher, was meist dadurch wett gemacht wird, dass ein geringerer Umfang an Daten abgefragt wird.
 
@@ -298,7 +276,7 @@ Da ein spezieller Fetcher zum Einsatz kommt und Daten daher einen sehr direkten
 
 Unter [.guihint]#Customize > Custom graphs# haben Sie die Möglichkeit, einen xref:graphing#custom_graphs[benutzerdefinierten Graphen] zu erstellen.
 Die Erstellung unterscheidet sich an einigen Stellen etwas von Graphen, die aus in RRDs hinterlegten Metriken erstellt werden.
-Näheres zeigt der Artikel zu Messwerten und Graphing.
+Näheres zeigt der Artikel zu xref:graphing#[Messwerten und Graphing].
 
 .Zuerst wählen Sie eine passende Metrik, die sie hinzufügen
 image::opentelemetry_custom_graph1.png[alt="Zuerst wählen Sie eine passende Metrik, die sie hinzufügen.",fullscreen=1]
@@ -309,8 +287,8 @@ image::opentelemetry_custom_graph2.png[alt="Klicken Sie sich durch die einzelnen
 .Hier wurde auf einen Datenpunkt eingeschränkt
 image::opentelemetry_custom_graph3.png[alt="Hier wurde auf einen Datenpunkt eingeschränkt.",fullscreen=1]
 
-.Mit dem Klick auf das Export-Icon öffnen Sie den Dialog zum Erstellen einer Spezialagentenregel
-image::opentelemetry_custom_graph4.png[alt="Mit dem Klick auf das Export-Icon öffnen Sie den Dialog zum Erstellen einer Spezialagentenregel.",fullscreen=1]
+.Mit dem Klick auf das Export-Symbol öffnen Sie den Dialog zum Erstellen einer Spezialagentenregel
+image::opentelemetry_custom_graph4.png[alt="Mit dem Klick auf das Export-Symbol öffnen Sie den Dialog zum Erstellen einer Spezialagentenregel.",fullscreen=1]
 
 Wenn Sie die im Graphen dargestellten OpenTelemetry-Datenpunkte über die verfügbaren Filter nach Attributen hinreichend eingeschränkt haben, können Sie über das Export-Symbol die erstellten Filter als Filter für einen Spezialagenten exportieren, den wir im folgenden Abschnitt vorstellen.
 
@@ -325,26 +303,21 @@ Die zwei auffälligsten Unterschiede zwischen benutzerdefinierten Graphen, die a
 
 
 [#special_agent_option]
-=== Benutzerdefinierte Metriken (_custom queries_) beliebigen Hosts zuordnen
-// TK: Ich bin verwirrt: ausgewählte Metriken, benutzerdefinierte Metriken, custom queries: Warum ist eine benutzerdefinierte Metrik eine custom query?
-// MFS: Ein custom query erzeugt eine benutzerdefinierte Metrik.
-// TK: Das ist doch eine interessante Info, die Du gerne im Artikel aufnehmen kannst.
-// TK: Dann sollte das im Titel geändert werden (im Wörterbuch hatten wir uns für Custom Metric auch im Deutschen entschieden): Custom Metrics beliebigen Hosts zuordnen
-// TK: Im ganzen Artikel sollte benutzerdefinierte Metrik durch Custom Metric ersetzt werden.
+=== Custom Metrics beliebigen Hosts zuordnen
 
 Alternativ zur Methode über [.guihint]#Customize > Custom graphs# können Sie unter [.guihint]#Setup > Agents > Other integrations > Metric backend (custom query)# den Spezialagenten konfigurieren, der einzelne Metriken aus dem Metrik-Backend als {CMK}-Services verfügbar macht.
 Hier finden Sie auch bereits aus benutzerdefinierten Graphen erzeugte Regeln und können diese anpassen -- der Exportmodus der benutzerdefinierten Graphen kann zwar Regeln erstellen, aber keine vorhandenen modifizieren.
-Eine benutzerdefinierte Metrik können Sie beliebigen Hosts zuordnen.
+Eine per [.guihint]#custom query# erzeugte benutzerdefinierte Metrik (_Custom Metric_) können Sie beliebigen Hosts zuordnen.
 
 [TIP]
 ====
-Aus benutzerdefinierten Graphen erstellte benutzerdefinierte Metriken sind auf eine OpenTelemetry-Metrik als Quelle limitiert.
+Aus benutzerdefinierten Graphen erstellte Custom Metrics sind auf eine OpenTelemetry-Metrik als Quelle limitiert.
 Falls Sie mehrere OpenTelemetry-Metriken als Quelle benötigen, müssen Sie in die in diesem Abschnitt vorgestellten Regeln zur Konfiguration des Spezialagenten verwenden, um weitere hinzuzufügen.
 Wenn Sie aus benutzerdefinierten Graphen mehrere Regeln für Spezialagenten erstellen, wird nur die jeweils erste matchende ausgeführt.
 ====
 
-.Bei den Regeln für Spezialagenten können Sie benutzerdefinierte Metriken bearbeiten oder neu anlegen
-image::opentelemetry_special_agent_rule.png[alt="Bei den Regeln für Spezialagenten könnet Sie benutzerdefinierte Metriken bearbeiten oder neu anlegen."]
+.Bei den Regeln für Spezialagenten können Sie Custom Metrics bearbeiten oder neu anlegen
+image::opentelemetry_special_agent_rule.png[alt="Bei den Regeln für Spezialagenten könnet Sie Custom Metrics bearbeiten oder neu anlegen."]
 
 ifdef::onprem[]
 Da die vom Spezialagenten erzeugten Metriken den „klassischen“ Weg über Monitoring-Kern und RRDs gehen, sind diese nicht von den xref:metric_backend#distributed[Einschränkungen im verteilten Monitoring] betroffen.
@@ -410,7 +383,7 @@ Statt der langen Verarbeitungskette mit Spezialagenten und Check-Plugin fragen j
 
 Für die Services können Sie Schwellwerte und mehr festlegen mit der Regel [.guihint]#Setup > Services > Service monitoring rules > OpenTelemetry#.
 Hier haben Sie die Möglichkeit, Regeln für einzelne oder alle Metriken eines Services festzulegen.
-An dieser Stelle sind die Konfigurationsmöglichkeiten deutlich größer als bei per [.guihint]#Custom query# erstellten benutzerdefinierten Metriken.
+An dieser Stelle sind die Konfigurationsmöglichkeiten deutlich größer als bei per [.guihint]#custom query# erstellten Custom Metrics.
 Der Beispiel-Screenshot zeigt die Auswahl des oben bereits gezeigten Zählers für die OpenTelemetry-Metrik `dice.rolls`.
 //Namen bekannter Metriken sind über die Liste beziehungsweise als Vorschlag während des Tippens zugänglich.
 //Noch unbekannte Metriken, bei denen Sie wissen, dass sie erscheinen werden, können Sie als Freitext eintragen.