Skip to content

Commit e2f05a0

Browse files
adjusting search links, formal updates, pick-25
1 parent e4bbf61 commit e2f05a0

2 files changed

Lines changed: 31 additions & 31 deletions

File tree

src/common/de/views.asciidoc

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
11
// -*- coding: utf-8 -*-
22
// IGNORE % Logfile checkboxes ➤
3-
// SKIPCOMMITS 2025-08-28
3+
// NONASCII
44
include::global_attr.adoc[]
55
= Ansichten von Hosts und Services (Views)
6-
:revdate: 2025-02-18
76
:title: Ansichten von Hosts und Services (Views)
87
:description: Tabellenansichten in {CMK} zeigen Zustände von Hosts und Services an. Lesen Sie hier, wie Sie Tabellenansichten nutzen, anpassen oder selbst erstellen.
98

@@ -14,6 +13,7 @@ xref:graphing#[Messwerte und Graphing]
1413
{related-end}
1514

1615

16+
[#intro]
1717
== Einleitung
1818

1919
Die wichtigste Aufgabe der xref:user_interface#[Benutzeroberfläche] von {CMK} ist das Anzeigen des aktuellen Zustands von Hosts und Services.
@@ -66,9 +66,7 @@ die Sie dann zu weiteren Tabellenansichten mit demselben Kontext bringen -- also
6666

6767
image::views_context_buttons.png[alt="Ansicht mit geöffnetem Menü 'Service'."]
6868

69-
Sie können Host- und Service-spezifische Tabellenansichten auch über die xref:intro_gui#search_monitor[Suche im Monitor-Menü] erreichen:
70-
71-
image::views_monitor_search.png[alt="Die Suche im Monitor-Menü.",width=60%,align=center]
69+
Sie können Host- und Service-spezifische Tabellenansichten auch über die xref:user_interface#search[Suche] im [.guihint]#Monitor#-Menü erreichen.
7270

7371
Ein weiterer Weg zu Detailansichten ist die Schnellsuche mit dem Snapin [.guihint]#Quicksearch# in der Seitenleiste:
7472

@@ -80,14 +78,14 @@ Wenn die Suche einen Host eindeutig ermittelt, dann gelangen Sie direkt zur Seit
8078
image::views_services_of_host.png[alt="Die Ansicht der Services eines Hosts."]
8179

8280
Dort finden Sie dann wieder die Menüeinträge zu den anderen Tabellenansichten des gleichen Hosts.
83-
Ein Klick auf den Namen des Hosts bringt Sie beispielsweise zur Ansicht [.guihint]#Status of Host.#
81+
Ein Klick auf den Namen des Hosts bringt Sie beispielsweise zur Ansicht [.guihint]#Status of Host#.
8482

8583

8684
=== Auswirkung in der Menüleiste
8785

8886
[#menucontext]
8987
Die Unterscheidung zwischen globalen, Host- und Service-spezifischen Tabellenansichten macht sich auch in der Menüleiste bemerkbar.
90-
Immer vorhanden sind die Menüs [.guihint]#Commands, Export, Display# und [.guihint]#Help.#
88+
Immer vorhanden sind die Menüs [.guihint]#Commands, Export, Display# und [.guihint]#Help#.
9189

9290
In globalen Host-Ansichten gibt es zudem das Menü [.guihint]#Hosts# sowie in globalen Service-Ansichten [.guihint]#Services# -- beachten Sie hier den Plural!
9391
Darüber können Sie zum Beispiel die xref:availability#[Verfügbarkeit] aller Hosts oder Services der aktuellen Ansicht aufrufen.
@@ -144,7 +142,7 @@ Beachten Sie, dass es in diesem Fall sein kann, dass Sie über ein inzwischen au
144142

145143
=== Zeit- und Datumsangaben
146144

147-
{CMK} zeigt in seinen Ansichten alle Zeitangaben, die weniger als 24 Stunden in der Vergangenheit oder Zukunft liegen, als relative Angaben -- also z.B. [.guihint]#16 hours.#
145+
{CMK} zeigt in seinen Ansichten alle Zeitangaben, die weniger als 24 Stunden in der Vergangenheit oder Zukunft liegen, als relative Angaben -- also z.B. [.guihint]#16 hours#.
148146
Sie können das im Menü über [.guihint]#Display > Modify display options# umschalten und wahlweise nur absolute, nur relative oder beide Werte anzeigen lassen, oder auch den „Unix Timestamp“.
149147
Auch das Datumsformat können Sie in diesem Dialog festlegen.
150148

@@ -164,7 +162,7 @@ Zunächst wird eine Tabellenansicht immer auf eine „natürliche“ Art sortier
164162
Bei den Service-Ansichten ist die Sortierung immer alphabetisch nach dem Namen des Services -- mit der Ausnahme, dass die [.guihint]#Check_MK#-Services immer oben stehen.
165163
Neben dem Service [.guihint]#Check_MK#, der für die Abfrage des Monitoring-Agenten zuständig ist, sind das noch [.guihint]#Check_MK Discovery#, [.guihint]#Check_MK HW/SW Inventory# und gegebenenfalls
166164
[.guihint]#Check_MK Agent#.
167-
Um eine solche Liste nach dem aktuellen Zustand der Services zu sortieren genügt ein Klick auf [.guihint]#State.#
165+
Um eine solche Liste nach dem aktuellen Zustand der Services zu sortieren genügt ein Klick auf [.guihint]#State#.
168166

169167
image::views_sort_by_state.png[alt="Sortierung einer Liste nach Spaltenüberschriften."]
170168

@@ -293,7 +291,7 @@ Sie können nämlich bestimmen, ob die Tabellenansicht _für alle Benutzer_ geä
293291
Dies legen Sie in den [.guihint]#General properties# der Tabellenansicht unter [.guihint]#Visibility# mit der Checkbox [.guihint]#Make this view available for other users# fest.
294292
Es überrascht wohl nicht, dass Sie diese Checkbox nur dann setzen können, wenn Sie xref:wato_user#roles[Administratorrechte] haben.
295293
ifdef::onprem[]
296-
Genau genommen gibt es dafür eine eigene Berechtigung mit dem Namen [.guihint]#Publish views.#
294+
Genau genommen gibt es dafür eine eigene Berechtigung mit dem Namen [.guihint]#Publish views#.
297295
Zusätzlich können einzelne Tabellenansichten in den xref:wato_user#roles[Rollendefinitionen] gesperrt werden.
298296
endif::[]
299297

@@ -343,10 +341,10 @@ legen folgende Eigenschaften unter [.guihint]#General properties# fest:
343341

344342
image::views_edit_view_general_properties.png[alt="Allgemeine Eigenschaften der Ansicht."]
345343

346-
* [.guihint]#Title:# Dies wird der Name des Eintrags.
347-
* [.guihint]#Topic in 'Monitor menu':# Unter diesem Thema wird die Tabellenansicht einsortiert. Sie können auch eigene Themen definieren.
348-
* [.guihint]#Sort index:# Entscheidet, wie weit oben die Tabellenansicht im Menü erscheint.
349-
* [.guihint]#Visibility:# Damit können Sie den Eintrag unterdrücken und/oder für andere Benutzer freigeben.
344+
* [.guihint]#Title#: Dies wird der Name des Eintrags.
345+
* [.guihint]#Topic in 'Monitor' menu#: Unter diesem Thema wird die Tabellenansicht einsortiert. Sie können auch eigene Themen definieren.
346+
* [.guihint]#Sort index#: Entscheidet, wie weit oben die Tabellenansicht im Menü erscheint.
347+
* [.guihint]#Visibility#: Damit können Sie den Eintrag unterdrücken und/oder für andere Benutzer freigeben.
350348

351349

352350
=== Grundlegendes Layout
@@ -417,7 +415,7 @@ image::views_edit_view_columns_2.png[alt="Eigenschaften einer 'Joined column' mi
417415

418416
Wenn Sie nicht genau wissen, wie der Service heißt oder er auf jedem Host ein wenig anders ist, geben Sie einen regulären Ausdruck an, der pro Host auf exakt *einen* Service matcht.
419417
Das ist vor allem dann nützlich, wenn Sie eine Gruppe von Hosts betrachten wollen, bei denen es eine vergleichbare Gruppe an Services gibt, von denen jeweils immer nur einer auf einem Host vorkommen kann.
420-
In dem nachfolgenden Beispiel ist das die [.guihint]#CPU load# oder die [.guihint]#Processor queue,# welche entweder nur auf Linux- oder Windows-Systemen vorkommen kann.
418+
In dem nachfolgenden Beispiel ist das die [.guihint]#CPU load# oder die [.guihint]#Processor queue#, welche entweder nur auf Linux- oder Windows-Systemen vorkommen kann.
421419

422420
image::views_edit_view_columns_3.png[alt="Eigenschaften einer 'Joined column' mit regulärem Ausdruck für den Service."]
423421

@@ -581,7 +579,7 @@ image::views_create_view_2.png[alt="Auswahl eines spezifischen Objekttyps."]
581579
Hier entscheidet sich, ob Ihre neue Tabellenansicht einen Kontext haben oder ob es eine globale Tabellenansicht werden soll.
582580
Welche Auswahlmöglichkeiten Sie haben, hängt von der gewählten Datenquelle ab.
583581
Der mit Abstand häufigste Kontext ist Host.
584-
Die Abbildung von oben erscheint nach der Auswahl der Datenquelle [.guihint]#All services.#
582+
Die Abbildung von oben erscheint nach der Auswahl der Datenquelle [.guihint]#All services#.
585583

586584
Durch das Aktivieren von [.guihint]#Show information of a single Host# legen Sie fest, dass die neue Tabellenansicht genau einen Host beschreibt.
587585
So haben Sie die Grundlage dafür geschaffen, dass die Tabellenansicht nicht global, sondern verlinkt sichtbar wird:
@@ -628,7 +626,7 @@ Da Daten aus der HW-/SW-Inventur immer zu einem bestimmten Host und einer bestim
628626

629627
image::views_create_view_5.png[alt="Dialog zur Auswahl der Spalten."]
630628

631-
Anschließend können Sie die definierten Makros nicht nur in den [.guihint]#Joined inventory columns# verwenden, sondern auch in den [.guihint]#Joined columns,#
629+
Anschließend können Sie die definierten Makros nicht nur in den [.guihint]#Joined inventory columns# verwenden, sondern auch in den [.guihint]#Joined columns#,
632630
um die Daten von bestimmten Services anzuzeigen.
633631
Das ermöglicht die Kombination unterschiedlichster Quellen -- in diesem Fall, das Perf-O-Meter des dazugehörigen Performance-Service einer Instanz anzuzeigen.
634632

@@ -638,11 +636,11 @@ image::views_create_view_6.png[alt="Auswahl einer 'Joined column' unter Verwendu
638636

639637
Daten aus anderen HW-/SW-Inventurtabellen anzuzeigen funktioniert ganz ähnlich.
640638
Lediglich die zu verwendende Tabelle ist vorher auszuwählen.
641-
In dem nachfolgenden Beispiel verwenden Sie die Tabelle [.guihint]#{CMK} ➤ {CMK} versions,# wodurch die Drop-down-Liste [.guihint]#Display the column# automatisch auf eine sinnvolle Auswahl eingeschränkt wird.
639+
In dem nachfolgenden Beispiel verwenden Sie die Tabelle [.guihint]#{CMK} ➤ {CMK} versions#, wodurch die Drop-down-Liste [.guihint]#Display the column# automatisch auf eine sinnvolle Auswahl eingeschränkt wird.
642640

643641
Wie {CMK} die richtige Zeile in der Tabelle findet, von der die Spalte angezeigt werden soll, bestimmen Sie danach.
644642
Fügen Sie dafür mit dem Knopf [.guihint]#Add new match criteria# ein Kriterium in Form einer Spalte hinzu, über das {CMK} später die passende Zeile bestimmen kann.
645-
In dem obigen Beispiel ist das die [.gui]#Version.#
643+
In dem obigen Beispiel ist das die [.gui]#Version#.
646644
Denn diese ist in der Tabelle einzigartig und kann nur einmal vorkommen.
647645
Das bedeutet umgekehrt auch, dass Sie zwar beliebige Tabellen der HW-/SW-Inventur miteinander verknüpfen können, Sie dabei aber auch sicherstellen müssen, dass die beiden Tabellen immer eine gemeinsame Spalte haben und diese Spalte auch immer einzigartige Einträge enthält.
648646
In dem obigen Beispiel wäre die Spalte [.guihint]#Sites# also kein geeignetes Kriterium, da es mehrere Editionen mit derselben Anzahl an Instanzen geben könnte.
@@ -667,8 +665,8 @@ Wenn Sie in den [.guihint]#View Properties# als [.guihint]#Basic Layout# bei ei
667665
werden Sie wahrscheinlich erstmal seltsame Dinge erleben und sich fragen, was das Ganze soll.
668666
Die Matrix ist sicher nicht auf den ersten Blick einleuchtend, aber Sie können damit tolle Dinge machen.
669667

670-
In den ausgelieferten Tabellenansichten gibt es z.B. [.guihint]#Search performance data,# die dieses Layout verwendet.
671-
Sie finden diese Tabellenansicht im Monitor-Menü unter [.guihint]#Monitor > History > Search performance data# und auch in [.guihint]#Customize > Visualization > Views.#
668+
In den ausgelieferten Tabellenansichten gibt es z.B. [.guihint]#Search performance data#, die dieses Layout verwendet.
669+
Sie finden diese Tabellenansicht im Monitor-Menü unter [.guihint]#Monitor > History > Search performance data# und auch in [.guihint]#Customize > Visualization > Views#.
672670
In der Liste der Views müssen Sie eventuell zuvor die Begrenzung auf die Anzeige von maximal 100 Zeilen aufheben.
673671

674672
Folgende Abbildung zeigt eine Suche nach dem Serviceausdruck `CPU|^memory|Filesystem /opt/omd/sites/mysite`:
@@ -680,7 +678,7 @@ Nicht alle Hosts haben die gleichen Services, so dass bei einigen Hosts dann die
680678

681679
image::views_matrix_view_1.png[alt="Ergebnis der Service-Suche in einer Matrixansicht."]
682680

683-
Das Ganze sieht jetzt erstmal sehr ähnlich aus wie die weiter oben beschriebene xref:joined_columns[Information über Services in einer Host-Ansicht.]
681+
Das Ganze sieht jetzt erstmal sehr ähnlich aus wie die weiter oben beschriebene xref:joined_columns[Information über Services in einer Host-Ansicht].
684682
Es gibt aber ein paar wesentliche Unterschiede:
685683

686684
. Die Liste der Services ist dynamisch und nicht fest konfiguriert.
@@ -782,6 +780,8 @@ Wenn Sie also die z.B. alle Bedienelemente, Knöpfe und Links abschalten und nur
782780
`/myserver/mysite/check_mk/view.py?view_name=allhosts&display_options=til`
783781
////
784782

783+
784+
[#icons]
785785
== Symbole und Aktionen hinzufügen
786786

787787
In Tabellenansichten von Hosts und Services sehen Sie auch eine Spalte für Symbole (_icons_) und darin das icon:icon_menu[alt="Symbol des Aktionsmenüs in der Tabellenansicht."] Aktionsmenü, aus dem Sie Host- beziehungsweise Service-Aktionen auswählen können.
@@ -817,7 +817,7 @@ ifdef::saas[]
817817
Sie müssen das Icon
818818
endif::[]
819819
als über xref:glossar#rule[Regeln] ansprechbares Objekt und optional eine zugehörige Aktion definieren.
820-
Die Einstellungen finden Sie unter [.guihint]#Setup > General > Global settings > User interface > Custom icons and actions.#
820+
Die Einstellungen finden Sie unter [.guihint]#Setup > General > Global settings > User interface > Custom icons and actions#.
821821
Erstellen Sie hier über [.guihint]#Add new element# einen neuen Eintrag und legen Sie [.guihint]#ID#, [.guihint]#Icon# und einen [.guihint]#Title# fest;
822822
der Titel wird übrigens später per On-Mouse-Over-Effekt als Tooltipp direkt am Symbol angezeigt und ist für die Benutzer damit sehr hilfreich.
823823

src/common/en/views.asciidoc

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
11
// -*- coding: utf-8 -*-
22
// IGNORE % Logfile ➤
3-
// SKIPCOMMITS 2025-08-28
3+
// NONASCII
44
include::global_attr.adoc[]
55
= Host and service views
6-
:revdate: 2025-02-18
76
:title: Host and service views
87
:description: Tabular views in {CMK} display states of hosts and services. Read here how to use, customize or create tabular views in your site.
98

@@ -14,6 +13,7 @@ xref:graphing#[Measured values and graphing]
1413
{related-end}
1514

1615

16+
[#intro]
1717
== Introduction
1818

1919
The most important task performed by {CMK}’s xref:user_interface#[user interface] is displaying the current state of hosts and services.
@@ -66,9 +66,7 @@ which will then take you to other views with the same context -- i.e. for the sa
6666

6767
image::views_context_buttons.png[alt="View with the 'Service' menu open."]
6868

69-
You can also access host- and service-specific views by xref:intro_gui#search_monitor[searching within the Monitor menu]:
70-
71-
image::views_monitor_search.png[alt="The search in the Monitor menu.",width=60%,align=center]
69+
You can also access host- and service-specific views by xref:user_interface#search[searching] in the [.guihint]#Monitor# menu.
7270

7371
Another way to the detailed view is via the [.guihint]#Quicksearch# snap-in in the sidebar:
7472

@@ -342,7 +340,7 @@ How and if a view will be shown in the [.guihint]#Monitor# menu of the navigatio
342340
image::views_edit_view_general_properties.png[alt="General properties of the view."]
343341

344342
* [.guihint]#Title# -- the item’s name
345-
* [.guihint]#Topic in 'Monitor menu':# -- the view will be sorted under this topic. You can also define other topics.
343+
* [.guihint]#Topic in 'Monitor' menu# -- the view will be sorted under this topic. You can also define other topics.
346344
* [.guihint]#Sort index# -- how high up the view appears in the menu
347345
* [.guihint]#Visibility# -- Suppress item and/or share with other users
348346

@@ -415,7 +413,7 @@ image::views_edit_view_columns_2.png[alt="Properties of a 'Joined column' with e
415413

416414
If you don't know exactly what the service is called, or its name is slightly different on each host, specify a regular expression that matches to exactly *one* service per host.
417415
This is especially useful if you want to look at a group of hosts where there is a comparable group of services, only one of which can be present on a host at any given time.
418-
In the example below, this is the [.guihint]#CPU load# or the [.guihint]#Processor queue,# which can only exist on either Linux or Windows systems.
416+
In the example below, this is the [.guihint]#CPU load# or the [.guihint]#Processor queue#, which can only exist on either Linux or Windows systems.
419417

420418
image::views_edit_view_columns_3.png[alt="Properties of a 'Joined column' with regular expression for the service."]
421419

@@ -626,7 +624,7 @@ Since data from the HW/SW inventory always belongs to a specific host and site,
626624

627625
image::views_create_view_5.png[alt="Dialog for selecting the columns."]
628626

629-
After that you can use the defined macros not only in the [.guihint]#Joined inventory columns#, but also in the [.guihint]#Joined columns,#
627+
After that you can use the defined macros not only in the [.guihint]#Joined inventory columns#, but also in the [.guihint]#Joined columns#,
630628
to display data from specific services.
631629
This allows you to combine a wide variety of sources -- in this example, to display the Perf-O-Meter for a site's associated performance service.
632630

@@ -776,6 +774,8 @@ For example -- if you want to switch off all control elements and buttons and on
776774
`/myserver/mysite/check_mk/view.py?view_name=allhosts&display_options=til`
777775
////
778776

777+
778+
[#icons]
779779
== Adding icons and actions
780780

781781
In views of hosts and services you will also see a column for icons, and in this the icon:icon_menu[alt="Icon of the action menu in the view."] action menu icon with which you can select host or service actions.

0 commit comments

Comments
 (0)