{"id":16828894,"url":"https://github.com/pjfanning/micrometer-akka-sample","last_synced_at":"2025-04-11T03:52:38.897Z","repository":{"id":44846270,"uuid":"119843572","full_name":"pjfanning/micrometer-akka-sample","owner":"pjfanning","description":"Sample demonstrating use of micrometer-akka","archived":false,"fork":false,"pushed_at":"2023-07-15T12:06:58.000Z","size":90,"stargazers_count":7,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-11T03:52:33.835Z","etag":null,"topics":["akka","akka-http","metrics","micrometer","micrometer-akka","prometheus","scala"],"latest_commit_sha":null,"homepage":"","language":"Scala","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pjfanning.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"pjfanning"}},"created_at":"2018-02-01T14:03:29.000Z","updated_at":"2023-01-17T07:35:35.000Z","dependencies_parsed_at":"2025-02-18T16:43:01.724Z","dependency_job_id":null,"html_url":"https://github.com/pjfanning/micrometer-akka-sample","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/pjfanning%2Fmicrometer-akka-sample","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pjfanning%2Fmicrometer-akka-sample/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pjfanning%2Fmicrometer-akka-sample/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pjfanning%2Fmicrometer-akka-sample/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pjfanning","download_url":"https://codeload.github.com/pjfanning/micrometer-akka-sample/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248339261,"owners_count":21087214,"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":["akka","akka-http","metrics","micrometer","micrometer-akka","prometheus","scala"],"created_at":"2024-10-13T11:29:06.112Z","updated_at":"2025-04-11T03:52:38.879Z","avatar_url":"https://github.com/pjfanning.png","language":"Scala","funding_links":["https://github.com/sponsors/pjfanning"],"categories":[],"sub_categories":[],"readme":"# micrometer-akka-sample\n\nThis sample demonstrates how to add [Micrometer-Akka](https://github.com/pjfanning/micrometer-akka) metrics to your application.\n\nThis sample is based on https://github.com/pjfanning/prometheus-akka-sample\n\n[Micrometer Metrics](http://micrometer.io/) compares itself to `SLF4J, but for metrics`.\n\nAll you need to do is add a dependency on the micrometer-akka jar, add some configuration to your [application.conf](https://github.com/pjfanning/micrometer-akka-sample/blob/main/src/main/resources/application.conf) and to enable aspectjweaver.\n\nThis sample uses `micrometer-registry-prometheus` to have the metrics registered as Prometheus client metrics.\nThis is setup in [Main.scala](https://github.com/pjfanning/micrometer-akka-sample/blob/main/src/main/scala/com/example/akka/Main.scala).\n\n```sbt clean run```\n\nThis sample uses [sbt-javaagent](https://github.com/sbt/sbt-javaagent) to enable aspectjweaver.\nThis plugin basically adds this to the java runtime command.\n\n```-javaagent:/path/to/aspectjweaver-1.9.19.jar```\n\nIf you want to use micrometer-akka with your own application, ensure that you startup script adds something like this:\n\n```bash\nJAVA_AGENT=\"-javaagent:$BASE/lib/aspectjweaver-1.9.19.jar\"\n$JAVA_HOME/bin/java $JAVA_AGENT -cp $CP $JVM_OPTS $CLASS_NAME\n```\n\nTo query the metrics endpoint, use:\n\n```curl http://localhost:12345/metrics```\n\n## Running with Java 16 and above\n\nNote that the `build.sbt` has this:\n```\n//uncomment this add-opens -- needed for Java 16 and above runtimes -- will cause issues if used with Java 8 runtime\nrun / javaOptions ++= Seq(\"--add-opens\", \"java.base/java.lang=ALL-UNNAMED\")\n```\n\nIf you use micrometer-akka in your own application, you will need to add an equivalent `--add-opens` configuration.\n\n## Grafana\n\nIf you want to visualise the metrics, you could try [Grafana](http://docs.grafana.org/).\nThe Prometheus website has a [page](https://prometheus.io/docs/visualization/grafana/) about setting up Prometheus Server to scrape your metrics and how to integrate this with Grafana.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpjfanning%2Fmicrometer-akka-sample","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpjfanning%2Fmicrometer-akka-sample","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpjfanning%2Fmicrometer-akka-sample/lists"}