{"id":25391468,"url":"https://github.com/bigouden/linky-exporter","last_synced_at":"2025-10-30T17:31:21.355Z","repository":{"id":127663058,"uuid":"364264265","full_name":"Bigouden/linky-exporter","owner":"Bigouden","description":"Linky Prometheus Exporter","archived":false,"fork":false,"pushed_at":"2025-01-20T22:05:27.000Z","size":162,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-20T23:19:02.777Z","etag":null,"topics":["alerting","devops","docker","metrics","monitoring","observability","prometheus","prometheus-exporter"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Bigouden.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2021-05-04T13:25:13.000Z","updated_at":"2025-01-20T22:05:31.000Z","dependencies_parsed_at":"2024-02-18T06:22:49.921Z","dependency_job_id":"2a4c18fc-bd0e-41e5-b72f-b696e73d4150","html_url":"https://github.com/Bigouden/linky-exporter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bigouden%2Flinky-exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bigouden%2Flinky-exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bigouden%2Flinky-exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bigouden%2Flinky-exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Bigouden","download_url":"https://codeload.github.com/Bigouden/linky-exporter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239015490,"owners_count":19568274,"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":["alerting","devops","docker","metrics","monitoring","observability","prometheus","prometheus-exporter"],"created_at":"2025-02-15T15:42:55.694Z","updated_at":"2025-10-30T17:31:21.012Z","avatar_url":"https://github.com/Bigouden.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Linky-Exporter\n\n## Description\n\nExporter Prometheus des trames remontées à partir d'un module téléinfo raccordé sur un compteur Linky.\n\n## Variable d'environement\n\n| Variable d'environement  | Description                                      | Valeur par défaut |\n|--------------------------|--------------------------------------------------|-------------------|\n| LINKY_EXPORTER_INTERFACE | Interface d'accès au compteur Linky              | /dev/ttyUSB0      |\n| LINKY_EXPORTER_LOGLEVEL  | Niveau de verbosité de l'exporter                | INFO              |\n| LINKY_EXPORTER_NAME      | Valeur 'job' des métriques remontées             | linky-exporter    |\n| LINKY_EXPORTER_PORT      | Port d'écoute de l'exporter                      | 8123              |\n| LINKY_EXPORTER_MODE      | Mode HISTORIQUE ou STANDARD                      | HISTORIQUE        |\n| LINKY_FRAME_TIMEOUT      | Durée d'attente d'une trame Linky                | 10                |\n| LINKY_SOCAT_HOST         | Mode SOCAT : IP:PORT associé à l'interface Linky |                   |\n| LINKY_SOCAT_FILE         | Mode SOCAT : Fichier associé à LINKY_SOCAT_HOST  |                   |\n\n## Format des métriques\n\nLes métriques remontées par l'exporter sont toutes préfixées par la chaine de caractère : **'linky_'**.\n\nPar exemple, l'index de base est disponible à travers la métrique : **linky_base**.\n\n```bash\n# HELP linky_isousc Intensité Souscrite en A\n# TYPE linky_isousc gauge\nlinky_isousc{adco=\"xxxxxxxxxxx\",hhphc=\"A\",imax=\"090\",job=\"linky-exporter\",motdetat=\"000000\",optarif=\"BASE\",ptec=\"TH..\"} 30.0\n# HELP linky_base_total Index Option Base en Wh\n# TYPE linky_base_total counter\nlinky_base{adco=\"xxxxxxxxxxx\",hhphc=\"A\",imax=\"090\",job=\"linky-exporter\",motdetat=\"000000\",optarif=\"BASE\",ptec=\"TH..\"} 2.35478e+06\n# HELP linky_iinst Intensité Instantanée en A\n# TYPE linky_iinst gauge\nlinky_iinst{adco=\"xxxxxxxxxxx\",hhphc=\"A\",imax=\"090\",job=\"linky-exporter\",motdetat=\"000000\",optarif=\"BASE\",ptec=\"TH..\"} 11.0\n# HELP linky_papp Puissance Apparente en VA\n# TYPE linky_papp gauge\nlinky_papp{adco=\"xxxxxxxxxxx\",hhphc=\"A\",imax=\"090\",job=\"linky-exporter\",motdetat=\"000000\",optarif=\"BASE\",ptec=\"TH..\"} 2610.0\n````\n\n## Lancement de l'exporter\n\nL'exporter est \"packagé\" sous forme de conteneur Docker.\n\nUne fois le conteneur construit, il peut être lancé comme suit :\n\n`docker run -dit --device=/dev/ttyUSB0 -v /dev/ttyUSB0:/dev/ttyUSB0 -p 8123:8123 linky-exporter`\n\n## Tableau de bord Grafana\n\nUn tableau de bord Grafana est disponible dans le répertoire **grafana** et permet l'exploitation des métriques remontées par l'exporter.\n\n_Capture d'écran :_\n\n![capture d'écran Grafana](grafana/grafana.png \"Capture d'écran Grafana\")\n[capture d'écran Grafana](grafana/grafana.png \"Capture d'écran Grafana\")\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigouden%2Flinky-exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbigouden%2Flinky-exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigouden%2Flinky-exporter/lists"}