{"id":45888131,"url":"https://github.com/tesibelda/ovirtstat","last_synced_at":"2026-02-27T16:51:40.389Z","repository":{"id":130013020,"uuid":"609328606","full_name":"tesibelda/ovirtstat","owner":"tesibelda","description":"oVirt Engine input plugin for Telegraf that gathers status and basic stats","archived":false,"fork":false,"pushed_at":"2025-11-03T11:28:46.000Z","size":247,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-11-03T13:16:54.411Z","etag":null,"topics":["metrics","monitoring","ovirt","ovirt-engine","telegraf","telegraf-plugin"],"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/tesibelda.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-03-03T21:54:23.000Z","updated_at":"2025-11-03T11:25:17.000Z","dependencies_parsed_at":"2024-06-20T04:16:34.255Z","dependency_job_id":"054648ca-76c8-4d2f-bf85-d227777589bc","html_url":"https://github.com/tesibelda/ovirtstat","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/tesibelda/ovirtstat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tesibelda%2Fovirtstat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tesibelda%2Fovirtstat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tesibelda%2Fovirtstat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tesibelda%2Fovirtstat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tesibelda","download_url":"https://codeload.github.com/tesibelda/ovirtstat/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tesibelda%2Fovirtstat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29905510,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T14:46:13.553Z","status":"ssl_error","status_checked_at":"2026-02-27T14:46:10.522Z","response_time":57,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["metrics","monitoring","ovirt","ovirt-engine","telegraf","telegraf-plugin"],"created_at":"2026-02-27T16:51:39.702Z","updated_at":"2026-02-27T16:51:40.380Z","avatar_url":"https://github.com/tesibelda.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ovirtstat execd input for telegraf\n\novirtstat is an [oVirt](https://www.ovirt.org/) input plugin for [Telegraf](https://github.com/influxdata/telegraf) that gathers status and basic stats from oVirt Engine using [go-ovirt](https://github.com/ovirt/go-ovirt).\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/tesibelda/ovirtstat/raw/master/LICENSE)\n[![Go Report Card](https://goreportcard.com/badge/github.com/tesibelda/ovirtstat)](https://goreportcard.com/report/github.com/tesibelda/ovirtstat)\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/tesibelda/ovirtstat?display_name=release)\n\n# Compatibility\n\nLatest releases are built with a go-ovirt library version that should work with oVirt 4.x. \n\n# Configuration\n\n* Download the [latest release package](https://github.com/tesibelda/ovirtstat/releases/latest) for your platform.\n\n* Edit ovirtstat.conf file as needed. Example:\n\n```toml\n## OVirt Engine URL to be monitored and its credential\novirturl = \"https://ovirt-engine.local/ovirt-engine/api\"\n## User and password of the REST API.\n## Use \"user@ovirt@internalsso\" schema for oVirt 4.5.1 or greater\nusername = \"user@internal\"\npassword = \"secret\"\ntimeout = \"10s\"\n\n## Optional SSL Config\n# tls_ca = \"/path/to/cafile\"\n## Use SSL but skip chain \u0026 host verification\n# insecure_skip_verify = false\n\n## optional alias tag for internal metrics\n# internal_alias = \"\"\n\n## Filter clusters by name, default is no filtering\n## cluster names can be specified as glob patterns\n# clusters_include = []\n# clusters_exclude = []\n\n## Filter hosts by name, default is no filtering\n## host names can be specified as glob patterns\n# hosts_include = []\n# hosts_exclude = []\n\n## Filter VMs by name, default is no filtering\n## VM names can be specified as glob patterns\n# vms_include = []\n# vms_exclude = []\n\n## Filter collectors by name, default is all collectors\n## see possible collector names bellow\n# collectors_include = []\n# collectors_exclude = []\n\n#### collector names available are (details in METRICS.md) ####\n## Datacenters: datacenter stats in ovirtstat_datacenter measurement\n## GlusterVolumes: gluster volume stats in ovirtstat_glustervolume measurement\n## Hosts: hypervisor/host stats in ovirtstat_host measurement\n## StorageDomains: cluster stats in ovirtstat_storagedomains measurement\n## VMs: virtual machine stats in ovirtstat_vm measurement\n```\n\n* Edit telegraf's execd input configuration as needed. Example:\n\n```\n## Gather oVirt Engine status and basic stats\n[[inputs.execd]]\n  command = [\"/path/to/ovirtstat_binary\", \"--config\", \"/path/to/ovirtstat.conf\"]\n  signal = \"STDIN\"\n```\n\nYou can optionally tell ovirtstat the input's interval by adding --poll_interval \u003cthe_interval\u003e parameters to the command. By default it expects 1m interval. If you want 30s interval configure it like this:\n```\n## Gather oVirt Engine status and basic stats\n[[inputs.execd]]\n  interval = \"30s\"\n  command = [\"/path/to/ovirtstat_binary\", \"--config\", \"/path/to/ovirtstat.conf\", \"--poll_interval\", \"30s\"]\n  signal = \"STDIN\"\n```\nMetric timestamp precision will be set according to the polling interval, so it will usually be 1s.\n\n* Restart or reload Telegraf.\n\n# Quick test in your environment\n\n* Edit ovirtstat.conf file as needed (see above)\n\n* Run ovirtstat with --config argument using that file.\n```\n/path/to/ovirtstat --config /path/to/ovirtstat.conf\n```\n\n* Press enter to force the collectin of metrics. You should see lines like those in the Example output below.\n\n\n# Example output\n\n```plain\novirtstat_apisummary,ovirt-engine=myovirt users=4i,vms_active=5i,vms_total=5i,version=\"4.4.10.7-1.0.17.el8\",hosts=5i,storagedomains=23i 1677832223000000000\novirtstat_datacenter,name=mydc,id=c3a7efc0-8417-4d1b-bc74-fa6f20d6bf1f,ovirt-engine=myovirt local=false,status=\"up\",status_code=0i,clusters=1i 1677832223000000000\novirtstat_host,clustername=mycluster,dcname=mydc,id=b3d53f5d-7ec3-43a8-a52a-15fe7dde25c2,name=myhyp01,ovirt-engine=myovirt,type=rhel cpu_threads=2i,memory_size=1622535045120i,status=\"up\",status_code=0i,cpu_cores=16i,cpu_sockets=2i,cpu_speed=800,reinstallation_required=false,vm_active=5i,vm_migrating=0i,vm_total=5i 1677832224000000000\novirtstat_storagedomain,id=072cba31-08f3-4a40-9f24-a5ca22ed1d74,name=ovirt-image-repository,ovirt-engine=myovirt,storage_type=glance,type=image available=0i,connections=0,committed=0i,external_status=\"ok\",external_status_code=0,logical_units=0i,master=false,status=\"unattached\",status_code=5i,used=0i 1677832224000000000\novirtstat_storagedomain,id=ec413fb2-c6ce-4bea-a790-2533b728ac93,name=mysd01,ovirt-engine=myovirt,storage_type=fcp,type=data available=3233036632064i,connections=7,committed=16603269824512i,external_status=\"ok\",external_status_code=0,logical_units=1i,master=true,status=\"\",status_code=3i,used=7761005903872i 1677832224000000000\novirtstat_glustervolume,clustername=mycluster,dcname=mydc,id=a1d52f5d-6vc3-42a8-a52f-21fe7dde25c2,name=mygv1,ovirt-engine=myovirt,type=stripe briks=1i,disperse_count=0i,redundancy_count=0i,replica_count=0i,status=\"up\",status_code=0i,stripe_count=1i 1677832224000000000\nvirtstat_vm,clustername=mycluster,dcname=mydc,hostname=myhyp01,id=125555e7-fa2c-4d95-a5c4-51f1b9a7f563,name=myvm01,ovirt-engine=myovirt,type=server cpu_cores=1i,cpu_threads=2i,run_once=false,status=\"up\",cpu_sockets=2i,memory_size=40802189312i,stateless=false,status_code=0i 1677832224000000000\ninternal_ovirtstat,ovirt-engine=myovirt,ovirtstat_version=0.1.0 sessions_created=1i,gather_time_ns=803780400i 1677832224000000000\n```\n\n# Metrics\nSee [Metrics](https://github.com/tesibelda/ovirtstat/blob/master/METRICS.md)\n\n# Build Instructions\n\nDownload the repo\n\n    $ git clone git@github.com:tesibelda/ovirtstat.git\n\nbuild the \"ovirtstat\" binary\n\n    $ go build -o bin/ovirtstat cmd/main.go\n    \n (if you're using windows, you'll want to give it an .exe extension)\n \n    $ go build -o bin\\ovirtstat.exe cmd/main.go\n\n If you use [go-task](https://github.com/go-task/task) execute one of these\n \n    $ task linux:build\n\t$ task windows:build\n\n# Author\n\nTesifonte Belda (https://github.com/tesibelda)\n\n# License\n\n[The MIT License (MIT)](https://github.com/tesibelda/ovirtstat/blob/master/LICENSE)\n\nUsed libraries:\n\n  go-ovirt [Apache-2.0 license](https://github.com/oVirt/go-ovirt/blob/master/LICENSE.txt)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftesibelda%2Fovirtstat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftesibelda%2Fovirtstat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftesibelda%2Fovirtstat/lists"}