Skip to content

docs: add single-host monitoring guide for Arc EL + CL#28

Open
Bela1401 wants to merge 2 commits intocirclefin:mainfrom
Bela1401:docs/single-host-monitoring
Open

docs: add single-host monitoring guide for Arc EL + CL#28
Bela1401 wants to merge 2 commits intocirclefin:mainfrom
Bela1401:docs/single-host-monitoring

Conversation

@Bela1401
Copy link
Copy Markdown

Summary

This PR adds a practical monitoring guide for operators running a single Arc
execution layer + consensus layer on one Ubuntu host.

It documents:

  • Prometheus scrape targets for EL and CL metrics
  • a minimal Grafana + Prometheus setup
  • dashboard provisioning
  • local access via SSH tunneling
  • common troubleshooting notes observed during real-world setup

Scope

This PR intentionally stays focused on a single-host operator setup and does not
attempt to cover multi-node or production observability architectures.

Related docs change

This PR also adds a reference from docs/running-an-arc-node.md to the new
docs/monitoring.md guide.

Notes

I kept the scope aligned with the feedback in the discussion:

  • placement under docs/monitoring.md
  • focused on one EL + one CL on one host
  • reuses the existing monitoring dashboards already present in the repository

Add Prometheus and Grafana setup instructions for a single Arc EL + CL node on one host.
Add a reference to docs/monitoring.md from running-an-arc-node.md.
@Bela1401
Copy link
Copy Markdown
Author

Opened this PR with the scope kept intentionally narrow: one execution layer + one consensus layer on one host, with Prometheus and Grafana for operator monitoring.

I also added the link from docs/running-an-arc-node.md to the new monitoring guide.

@Bela1401
Copy link
Copy Markdown
Author

Validation screenshot from a live single-host setup is attached below.
1
2
3

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.

1 participant