Skip to content

Commit 595509c

Browse files
committed
Add basic containerdebug logs
1 parent 3570a68 commit 595509c

File tree

3 files changed

+25
-0
lines changed

3 files changed

+25
-0
lines changed

modules/concepts/nav.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,4 +24,5 @@
2424
** Observability
2525
*** xref:labels.adoc[]
2626
*** xref:logging.adoc[]
27+
*** xref:containerdebug.adoc[]
2728
** xref:container-images.adoc[]
Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
= Container environment
2+
3+
All Stackable-managed products regularly log information about their operating
4+
environment, such as available disk interfaces and network interfaces.
5+
6+
This logging is performed by our https://github.com/stackabletech/containerdebug[containerdebug] tool.
7+
8+
NOTE: This tool is intended as a debugging aid, and the particular information or
9+
format should not be considered stable.
10+
11+
== Interval
12+
13+
This runs every minute. It can also be triggered manually, by running the
14+
`containerdebug` command, inside of the main product container.
15+
16+
== Output
17+
18+
This information is logged to the Kubernetes pod logs (readable via `kubectl logs <pod>`)
19+
and to the xref:logging.adoc#architecture[shared Stackable log dir]
20+
(for pickup by the Vector log agent).
21+
22+
Additionally, it is written as JSON to `/stackable/log/containerdebug-state.json`.
23+
This file only contains the output from the _latest_ containerdebug run.

modules/concepts/pages/logging.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,7 @@ This way you can get a detailed view of the operations of a component while view
3030
Logging for each product is configured in the Stacklet resource.
3131
For advanced log configurations, supplying custom product specific log configuration files is also supported.
3232

33+
[#architecture]
3334
== Architecture
3435

3536
Below you can see the overall architecture using ZooKeeper as an example.

0 commit comments

Comments
 (0)