Differential D5395 Diff 19324 docs/tutorials/issue-debugging-monitoring.md

Changeset View

Standalone View

docs/tutorials/issue-debugging-monitoring.md

	Show First 20 Lines • Show All 92 Lines • ▼ Show 20 Lines

	SWH instance URL: <http://kibana0.internal.softwareheritage.org:5601/app/kibana/>			SWH instance URL: <http://kibana0.internal.softwareheritage.org:5601/app/kibana/>
	Access to the SWH VPN is needed, but credentials are not.			Access to the SWH VPN is needed, but credentials are not.

	Related wiki page: <https://intranet.softwareheritage.org/wiki/Kibana>			Related wiki page: <https://intranet.softwareheritage.org/wiki/Kibana>

	Official documentation: <https://www.elastic.co/guide/en/kibana/current/index.html>			Official documentation: <https://www.elastic.co/guide/en/kibana/current/index.html>

	Kibana is a vizualization UI for searching through indexed logs. You can search through			Kibana is a visualization UI for searching through indexed logs. You can search through
	different sources of logs in the "Discover" pane. The sources configured include			different sources of logs in the "Discover" pane. The sources configured include
	application logs for SWH services and system logs. You can also access dashboards shared			application logs for SWH services and system logs. You can also access dashboards shared
	by other on a particular topic or create our own from a saved search.			by other on a particular topic or create our own from a saved search.

	There are 2 query languages which are quite similar: Lucene or KQL. Whatever one you			There are 2 query languages which are quite similar: Lucene or KQL. Whatever one you
	choose, you will have the same querying capabilities. A query tries to match values for			choose, you will have the same querying capabilities. A query tries to match values for
	specific keys, and support many predicates and combination of them. See the			specific keys, and support many predicates and combination of them. See the
	documentation for KQL: https://www.elastic.co/guide/en/kibana/current/kuery-query.html			documentation for KQL: https://www.elastic.co/guide/en/kibana/current/kuery-query.html
	Show All 21 Lines
	track.			track.

	You can save a search, as opposed to only a query, to easily get back to it or include			You can save a search, as opposed to only a query, to easily get back to it or include
	it in a dashboard. Just click "Save" in the top toolbar above the search bar. It			it in a dashboard. Just click "Save" in the top toolbar above the search bar. It
	includes the query, filters, selected columns, sorting and index pattern.			includes the query, filters, selected columns, sorting and index pattern.

	Now you may want to have a customizable view of these logs, along with graphical			Now you may want to have a customizable view of these logs, along with graphical
	presentations. In the "Dashboard" pane, create a new dashboard. Click "add" in the top			presentations. In the "Dashboard" pane, create a new dashboard. Click "add" in the top
	toolbar and select your saved search. It will appear in resizeable panel. Now doing a			toolbar and select your saved search. It will appear in resizable panel. Now doing a
	search will restrict the search to the dataset cinfigured for the panels.			search will restrict the search to the dataset configured for the panels.
				ardumontUnsubmitted Done Inline Actions resizeable made more sense... What's a realizable panel? ardumont: resizeable made more sense... What's a realizable panel?
				vlorentzAuthorUnsubmitted Done Inline Actions resizable? I don't know vlorentz: resizable? I don't know
				vlorentzAuthorUnsubmitted Done Inline Actions oh yeah, resizable. I selected the wrong option in aspell vlorentz: oh yeah, resizable. I selected the wrong option in aspell

	To create more complete vizualizations including graphs, refer to:			To create more complete visualizations including graphs, refer to:
	<https://www.elastic.co/guide/en/kibana/current/dashboard.html>			<https://www.elastic.co/guide/en/kibana/current/dashboard.html>