Skip to content

Commit

Permalink
Add documentation for static Pods log scraping configuration (#593)
Browse files Browse the repository at this point in the history
  • Loading branch information
jessejlt authored Feb 28, 2025
1 parent fc36faf commit 31ac769
Showing 1 changed file with 24 additions and 0 deletions.
24 changes: 24 additions & 0 deletions docs/designs/static-pods.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# Static Pods

## Background

In some scenarios, Pods cannot be annotated for log collection, particularly in cases involving static Pod manifests (such as kube-apiserver). This document describes a mechanism to configure log scraping for these Pods without requiring changes to their manifests.

### Proposed Solution

Introduce a configuration block that specifies which Pod log targets should be collected. When a target configuration matches a static Pod, the appropriate logs will be included in the overall log collection pipeline.

## Configuration

A sample configuration that aims to scrape kube-apiserver logs is provided below. The configuration itself remains unchanged:

```toml
[[host-log.static-pod-target]]
namespace = "kube-system"
label-targets = { "component" = "kube-apiserver" }
container = "apiserver"
log-type = "kubernetes"
database = "Logs"
table = "KubeAPIServer"
parsers = ["klog"]
```

0 comments on commit 31ac769

Please sign in to comment.