Skip to content

docs: add documentation for filters and optional analyzers#775

Merged
AlexsJones merged 1 commit intok8sgpt-ai:mainfrom
NoNickeD:docs/685-filters-analyzers-documentation
Jan 8, 2026
Merged

docs: add documentation for filters and optional analyzers#775
AlexsJones merged 1 commit intok8sgpt-ai:mainfrom
NoNickeD:docs/685-filters-analyzers-documentation

Conversation

@NoNickeD
Copy link
Contributor

Summary

This PR adds documentation explaining how to use the filters field to enable optional analyzers such as Log (logAnalyzer) and HorizontalPodAutoscaler (hpaAnalyzer).

Changes

  • Add "Filters (Analyzers)" section to README.md containing:
    • List of core analyzers (enabled by default)
    • List of optional analyzers (disabled by default)
    • Explanation that specifying filters replaces the default analyzer list
    • Usage examples showing how to enable optional analyzers
  • Update config/samples/exhaustive_sample.yaml with inline comments listing available analyzers
  • Add new config/samples/filters_example.yaml sample file demonstrating filters usage

Problem

Users were unable to determine how to enable optional analyzers like logAnalyzer or hpaAnalyzer when using the K8sGPT Operator. The existing documentation did not explain:

  • What analyzers are available
  • Which analyzers are enabled by default vs optional
  • That specifying filters replaces the defaults rather than adding to them

Fixes #685

Test plan

  • Verify README.md renders correctly on GitHub
  • Verify example YAML files are valid

@NoNickeD NoNickeD requested review from a team as code owners November 26, 2025 06:05
Add documentation explaining how to use the filters field to enable
optional analyzers like Log and HorizontalPodAutoscaler.

Changes:
- Add "Filters (Analyzers)" section to README.md with:
  - List of core analyzers (enabled by default)
  - List of optional analyzers (disabled by default)
  - Explanation that filters replace defaults
  - Usage examples
- Update exhaustive_sample.yaml with inline comments about available analyzers
- Add new filters_example.yaml sample file

Fixes k8sgpt-ai#685

Signed-off-by: nikos.nikolakakis <nonickedgr@gmail.com>
@NoNickeD NoNickeD force-pushed the docs/685-filters-analyzers-documentation branch from 00f6480 to f654a82 Compare November 26, 2025 06:07
@AlexsJones AlexsJones merged commit b58dc1e into k8sgpt-ai:main Jan 8, 2026
2 checks passed
@AlexsJones
Copy link
Member

Thanks @NoNickeD :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Question]: how to enable optional analyzer such as logAnalyzer or hpaAnalyzer

2 participants