Skip to content

Conversation

sthaha
Copy link
Collaborator

@sthaha sthaha commented Jul 16, 2025

Add detailed documentation explaining how Kepler measures and attributes power consumption to processes, containers, VMs, and pods. The guide includes:

  • Bird's eye view of power measurement approach using apartment building analogy
  • Step-by-step explanation of active vs idle power split concept
  • Detailed architecture breakdown covering device layer, node calculation, and process attribution
  • Real-world examples with concrete numbers from power attribution diagram
  • Implementation details including thread safety, error handling, and configuration
  • Monitoring and debugging guidance for developers and users

Also establish proper documentation structure:

  • Add docs/index.md as main documentation entry point
  • Add docs/developer/index.md to organize developer documentation
  • Include power attribution diagram asset

@github-actions github-actions bot added the docs Documentation changes label Jul 16, 2025
Add detailed documentation explaining how Kepler measures and attributes
power consumption to processes, containers, VMs, and pods. The guide includes:

- Bird's eye view of power measurement approach using apartment building analogy
- Step-by-step explanation of active vs idle power split concept
- Detailed architecture breakdown covering device layer, node calculation,
  and process attribution
- Real-world examples with concrete numbers from power attribution diagram
- Implementation details including thread safety, error handling, and configuration
- Monitoring and debugging guidance for developers and users

Also establish proper documentation structure:
- Add docs/index.md as main documentation entry point
- Add docs/developer/index.md to organize developer documentation
- Include power attribution diagram asset

Signed-off-by: Sunil Thaha <sthaha@redhat.com>
@sthaha sthaha force-pushed the doc-power-computation branch from bf1c06e to 3296f3c Compare July 16, 2025 04:11
@sthaha sthaha requested review from vprashar2929 and sunya-ch July 16, 2025 04:12
Copy link
Collaborator

@sunya-ch sunya-ch left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM.
It might need some updates down the line, but it’s a solid first version.

@sunya-ch sunya-ch merged commit 8cc9fd3 into sustainable-computing-io:main Jul 16, 2025
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation changes
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants