Skip to content

Conversation

@sai-kumar-peddireddy
Copy link
Collaborator

@sai-kumar-peddireddy sai-kumar-peddireddy commented Dec 9, 2025

Description

docs: add Events Hub user guides and reference documentation

Introduces a new documentation section for the Events Hub WebSocket service in docs/docs/devops/events-hub/.

  • Add overview.md: Covers WebSocket protocol details, authentication (Bearer/API Key), connection limits, and available channels (global, pdfm, orchestrator, health).
  • Add "How-to" guides:
    • how-to-monitor-VM-events.md: Subscribing to VM lifecycle events with JSON payload examples.
    • how-to-monitor-orchestrator-events.md: Monitoring cluster-level events like host health and VM state changes.
    • how-to-send-heartbeat.md: Implementing ping/pong logic to keep connections alive.
    • how-to-send-unsubscribe-requests.md & how-to-know-my-client-id.md: Managing subscriptions and client identity.
  • Visualizations: Integrate Mermaid.js todocs: add Events Hub user guides and reference documentation

Closes #332

Type of change

  • Documentation Change

Checklist

  • I have performed a self-review of my own code
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have run tests that prove my fix is effective or that my feature works
  • I have updated the CHANGELOG.md file accordingly

@sai-kumar-peddireddy sai-kumar-peddireddy self-assigned this Dec 9, 2025
@boring-cyborg boring-cyborg bot added documentation Improvements or additions to documentation test Tests labels Dec 9, 2025
@sai-kumar-peddireddy sai-kumar-peddireddy force-pushed the event-hub-doc branch 2 times, most recently from 461bf64 to bc63daa Compare December 10, 2025 12:04
@sai-kumar-peddireddy sai-kumar-peddireddy force-pushed the event-hub-doc branch 3 times, most recently from c370a20 to 18a0144 Compare December 15, 2025 12:46
@sai-kumar-peddireddy sai-kumar-peddireddy marked this pull request as ready for review December 15, 2025 12:47
@sai-kumar-peddireddy sai-kumar-peddireddy enabled auto-merge (squash) December 15, 2025 12:48
Introduces a new documentation section for the Events Hub WebSocket service in `docs/docs/devops/events-hub/`.

- Add `overview.md`: Covers WebSocket protocol details, authentication (Bearer/API Key), connection limits, and available channels (`global`, `pdfm`, `orchestrator`, `health`).
- Add "How-to" guides:
  - `how-to-monitor-VM-events.md`: Subscribing to VM lifecycle events with JSON payload examples.
  - `how-to-monitor-orchestrator-events.md`: Monitoring cluster-level events like host health and VM state changes.
  - `how-to-send-heartbeat.md`: Implementing ping/pong logic to keep connections alive.
  - `how-to-send-unsubscribe-requests.md` & `how-to-know-my-client-id.md`: Managing subscriptions and client identity.
- Visualizations: Integrate Mermaid.js todocs: add Events Hub user guides and reference documentation
@sai-kumar-peddireddy sai-kumar-peddireddy merged commit 764c83d into main Dec 16, 2025
15 checks passed
@sai-kumar-peddireddy sai-kumar-peddireddy deleted the event-hub-doc branch December 16, 2025 08:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation test Tests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[PBI] Implement documentation for the new EventHub

3 participants