{"id":23478368,"url":"https://github.com/opennms/opennms-cortex-tss-plugin","last_synced_at":"2026-03-11T17:03:34.810Z","repository":{"id":43017875,"uuid":"266149485","full_name":"OpenNMS/opennms-cortex-tss-plugin","owner":"OpenNMS","description":"OpenNMS Cortex Time Series Storage (TSS) Plugin","archived":false,"fork":false,"pushed_at":"2025-07-18T20:07:57.000Z","size":580,"stargazers_count":5,"open_issues_count":11,"forks_count":4,"subscribers_count":22,"default_branch":"master","last_synced_at":"2025-07-18T22:58:17.494Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OpenNMS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2020-05-22T15:53:03.000Z","updated_at":"2025-07-18T20:08:00.000Z","dependencies_parsed_at":"2024-03-27T19:28:36.972Z","dependency_job_id":"901ee28e-77ba-46f4-8ff6-a61c2b0ca118","html_url":"https://github.com/OpenNMS/opennms-cortex-tss-plugin","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/OpenNMS/opennms-cortex-tss-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenNMS%2Fopennms-cortex-tss-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenNMS%2Fopennms-cortex-tss-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenNMS%2Fopennms-cortex-tss-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenNMS%2Fopennms-cortex-tss-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OpenNMS","download_url":"https://codeload.github.com/OpenNMS/opennms-cortex-tss-plugin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenNMS%2Fopennms-cortex-tss-plugin/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268500608,"owners_count":24260163,"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","status":"online","status_checked_at":"2025-08-03T02:00:12.545Z","response_time":2577,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-12-24T19:19:03.710Z","updated_at":"2026-03-11T17:03:34.730Z","avatar_url":"https://github.com/OpenNMS.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OpenNMS Cortex Plugin [![CircleCI](https://circleci.com/gh/OpenNMS/opennms-cortex-tss-plugin.svg?style=svg)](https://circleci.com/gh/OpenNMS/opennms-cortex-tss-plugin)\n\nThis plugin exposes an implementation of the [TimeSeriesStorage](https://github.com/OpenNMS/opennms-integration-api/blob/v0.4.1/api/src/main/java/org/opennms/integration/api/v1/timeseries/TimeSeriesStorage.java#L40) interface that converts metrics to a Prometheus model and delegates writes \u0026 reads to [Cortex](https://cortexmetrics.io/).\n\n![arch](assets/cortex-plugin-arch.png \"Cortex Plugin Architecture\")\n\n## Usage\n\nStart Cortex - see https://cortexmetrics.io/docs/getting-started/\n\nYou can also download:\n\nhttps://github.com/opennms-forge/stack-play/tree/master/standalone-cortex-minimal\n\nand start with\n`docker-compose up`\n\nBuild and install the plugin into your local Maven repository using:\n```\nmvn clean install\n```\n\nEnable the TSS and configure:\n```\necho 'org.opennms.timeseries.strategy=integration\norg.opennms.timeseries.tin.metatags.tag.node=${node:label}\norg.opennms.timeseries.tin.metatags.tag.location=${node:location}\norg.opennms.timeseries.tin.metatags.tag.geohash=${node:geohash}\norg.opennms.timeseries.tin.metatags.tag.ifDescr=${interface:if-description}' \u003e\u003e ${OPENNMS_HOME}/etc/opennms.properties.d/cortex.properties\n```\n\nFrom the OpenNMS Karaf shell:\n```\nfeature:repo-add mvn:org.opennms.plugins.timeseries/cortex-karaf-features/1.0.0-SNAPSHOT/xml\nfeature:install opennms-plugins-cortex-tss\n```\n\nConfigure (you can omit that if you use the default values):\n```\nconfig:edit org.opennms.plugins.tss.cortex\n\nproperty-set writeUrl http://localhost:9009/api/prom/push\nproperty-set readUrl http://localhost:9009/prometheus/api/v1\nproperty-set maxConcurrentHttpConnections 100\nproperty-set writeTimeoutInMs 1000\nproperty-set readTimeoutInMs 1000\nproperty-set metricCacheSize 1000\nproperty-set externalTagsCacheSize 1000\nproperty-set bulkheadMaxWaitDurationInMs 9223372036854775807\n\nconfig:update\n```\n\nUpdate automatically:\n```\nbundle:watch *\n```\n\n## Cortex tips\n\n### View the ring\n\nhttp://localhost:9009/ring\n\n### View internal metrics\n\nhttp://localhost:9009/metrics\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopennms%2Fopennms-cortex-tss-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopennms%2Fopennms-cortex-tss-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopennms%2Fopennms-cortex-tss-plugin/lists"}