{"id":18928829,"url":"https://github.com/lightninglabs/lndmon","last_synced_at":"2025-04-04T20:11:25.095Z","repository":{"id":41945679,"uuid":"176790300","full_name":"lightninglabs/lndmon","owner":"lightninglabs","description":"🔎lndmon: A drop-in monitoring solution for your lnd node using Prometheus+Grafana","archived":false,"fork":false,"pushed_at":"2024-12-02T14:53:06.000Z","size":609,"stargazers_count":157,"open_issues_count":24,"forks_count":49,"subscribers_count":25,"default_branch":"master","last_synced_at":"2025-03-28T19:08:15.858Z","etag":null,"topics":["bitcoin","grafana","lightning","lnd","monitoring","prometheus"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lightninglabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-03-20T18:04:06.000Z","updated_at":"2025-03-11T13:03:17.000Z","dependencies_parsed_at":"2024-01-24T05:24:04.252Z","dependency_job_id":"abce2a33-713e-4df8-a266-4ee21e2fcccc","html_url":"https://github.com/lightninglabs/lndmon","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightninglabs%2Flndmon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightninglabs%2Flndmon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightninglabs%2Flndmon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightninglabs%2Flndmon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lightninglabs","download_url":"https://codeload.github.com/lightninglabs/lndmon/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247242678,"owners_count":20907134,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bitcoin","grafana","lightning","lnd","monitoring","prometheus"],"created_at":"2024-11-08T11:28:11.817Z","updated_at":"2025-04-04T20:11:25.064Z","avatar_url":"https://github.com/lightninglabs.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# lndmon\n\n#### A drop-in monitoring solution for your lnd node using Prometheus and Grafana.\n\n\u003cimg src=\"dashboard.png\"\u003e\n\n## What is this?\n\n`lndmon` is a drop-in, dockerized monitoring/metric collection solution for your\nindividual lnd nodes connected to bitcoin. With this system, you'll be able to\nclosely monitor the health and status of your `lnd` node.\n\nThere are three primary components of the `lndmon` system:\n\n1. [lnd](https://github.com/lightningnetwork/lnd) built with the `monitoring`\n   tag, which enables lnd to export metrics about its gRPC performance and\n   usage. These metrics provide insights such as how many bytes lnd is\n   transmitting over gRPC, whether any calls are taking a long time to complete,\n   and other related statistics.\n\n2. `lndmon`: while lnd provides some information, `lndmon` by far does the heavy\n   lifting with regards to metrics. With `lndmon`'s data, you can track routing\n   fees over time, track how the channel graph evolves, and have a highly\n   configurable \"crystal ball\" to forecast and de-escalate potential issues as\n   the network changes over time. There is also a strong set of metrics for\n   users who want to keep track of their own node and channels, or just explore\n   and create their own lightning data visualizations.\n\n3. Last but not least, `lndmon` uses [Grafana](https://grafana.com/) as its\n   primary dashboard to display all its collected metrics. Grafana is highly\n   configurable and can create beautiful and detailed graphs organized by\n   category (i.e., chain-related graphs, fee-related graphs, etc). Users have\n   the option of making their Grafana dashboards remotely accessible over TLS\n   with passwords to ensure their data is kept private.\n\n## Why would I want to use this?\n\nMonitoring can provide crucial insights into the health of large-scale\ndistributed systems. Without monitoring systems like `lndmon`, the only view\ninto the health of your lnd node and the overall network is (1) fragmented logs,\nand (2) individually-dispatched `getinfo` and similar commands. By exporting and\ngraphing interesting metrics, one can get a real-time transparent view of the\nbehavior of your lnd node and the network. It's also cool to see how this view\nchanges over time and how it's affected by events in the larger bitcoin\necosystem (i.e., \"wow, the day [Lightning\nApp](https://github.com/lightninglabs/lightning-app) was released coincides with\nthe addition of 3000 channels to the network!\").\n\n## How do I install this?\n\nHead over to [`INSTALL.md`](https://github.com/lightninglabs/lndmon/blob/master/INSTALL.md). It\nalso includes instructions to set up, access, and password-protect the dashboard\nthat comes with Prometheus, called the Prometheus expression browser, for those\ninterested in using it.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flightninglabs%2Flndmon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flightninglabs%2Flndmon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flightninglabs%2Flndmon/lists"}