{"id":26032705,"url":"https://github.com/apache/geronimo-metrics","last_synced_at":"2025-04-10T00:42:03.920Z","repository":{"id":49224595,"uuid":"136821340","full_name":"apache/geronimo-metrics","owner":"apache","description":"Apache Geronimo Metrics","archived":false,"fork":false,"pushed_at":"2025-03-17T10:25:27.000Z","size":199,"stargazers_count":1,"open_issues_count":3,"forks_count":8,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-04-03T04:16:55.893Z","etag":null,"topics":["geronimo","http","java","javaee","network-server","web-framework"],"latest_commit_sha":null,"homepage":"https://geronimo.apache.org/","language":"Java","has_issues":false,"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/apache.png","metadata":{"files":{"readme":"README.adoc","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":"2018-06-10T15:34:42.000Z","updated_at":"2025-03-17T10:25:32.000Z","dependencies_parsed_at":"2025-03-17T11:39:17.374Z","dependency_job_id":null,"html_url":"https://github.com/apache/geronimo-metrics","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fgeronimo-metrics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fgeronimo-metrics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fgeronimo-metrics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fgeronimo-metrics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apache","download_url":"https://codeload.github.com/apache/geronimo-metrics/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247899657,"owners_count":21014937,"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":["geronimo","http","java","javaee","network-server","web-framework"],"created_at":"2025-03-06T22:49:50.791Z","updated_at":"2025-04-10T00:42:03.898Z","avatar_url":"https://github.com/apache.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"= Geronimo Microprofile Metrics Implementation\n\n== Artifact\n\n[source,xml]\n----\n\u003cparent\u003e\n  \u003cgroupId\u003eorg.apache.geronimo\u003c/groupId\u003e\n  \u003cartifactId\u003egeronimo-metrics\u003c/artifactId\u003e\n  \u003cversion\u003e${metrics.version}\u003c/version\u003e\n\u003c/parent\u003e\n----\n\n\n== Renaming Prometheus keys\n\nPrometheus exporter can rename metrics keys providing\na properties file in the classpath as resource `META-INF/geronimo-metrics/prometheus-mapping.properties`\nor using system properties (with the prefix `geronimo.metrics.prometheus.mapping.`).\n\nThe key is the metric key (with the registry type as prefix) and the value the replacement key:\n\n[source]\n----\nbase\\:my_metric = app:metric\n----\n\nTIP: since it is a properties format the `:` must be escaped.\n\nThe specific key `geronimo.metrics.filter.prefix` can take\na list (comma separated values) of metrics prefixes to filter (whitelist)\nexported metrics.\n\n== Controlling the metrics endpoints exposure\n\nTo activate the metrics endpoints you have to set the system property `geronimo.metrics.jaxrs.activated` to true\nor configure either a role or host supported for the endpoint.\n\nThe role validation will use the JAX-RS `SecurityContext`.\nIt relies on the system property `geronimo.metrics.jaxrs.acceptedRoles` and it takes a comma separated list of roles.\nAt least one must match to let the request pass, if none is set this validation is ignored.\nNote that a request without a principal will lead to a HTTP 401 whereas a request with a principal but not the right role will issue a HTTP 403.\n\nThe host validation will use the JAX-RS `UriInfo#getRequestUri`.\nIt relies on the system property `geronimo.metrics.jaxrs.acceptedHosts` and it takes a comma separated list of roles.\nAt least one must match to let the request pass, if none is set this validation is ignored.\nThe `\u003clocal\u003e` value is an alias for `127.x.y.z` or `1::x` IP or `localhost`.\n\nConfiguration example:\n\n[source]\n----\n-Dgeronimo.metrics.jaxrs.acceptedRoles=ops \\\n-Dgeronimo.metrics.jaxrs.acceptedHosts=my.remote.host\n----\n\nIMPORTANT: the default is `geronimo.metrics.jaxrs.acceptedHosts=\u003clocal\u003e` but you can disable the endpoints using `geronimo.metrics.jaxrs.activated=false`.\n\n=== Security\n\nIMPORTANT: default will allow all local calls, this means that if you are behind a proxy which does not propagate the request URI properly\nyour `/metrics` endpoints will be public.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fgeronimo-metrics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapache%2Fgeronimo-metrics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fgeronimo-metrics/lists"}