{"id":18713681,"url":"https://github.com/moliva/metrics-example","last_synced_at":"2025-11-10T00:30:18.715Z","repository":{"id":257491063,"uuid":"811076473","full_name":"moliva/metrics-example","owner":"moliva","description":"Ejemplo de servicio de métricas","archived":false,"fork":false,"pushed_at":"2024-06-08T18:20:25.000Z","size":1321,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-18T13:49:20.820Z","etag":null,"topics":["example","javalin","metrics","micrometer"],"latest_commit_sha":null,"homepage":"","language":"Java","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/moliva.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}},"created_at":"2024-06-05T22:22:31.000Z","updated_at":"2024-09-16T21:18:12.000Z","dependencies_parsed_at":"2024-09-17T03:20:25.115Z","dependency_job_id":"522433e5-1079-4ccf-8b66-54910b44a09a","html_url":"https://github.com/moliva/metrics-example","commit_stats":null,"previous_names":["moliva/metrics-example"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moliva%2Fmetrics-example","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moliva%2Fmetrics-example/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moliva%2Fmetrics-example/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moliva%2Fmetrics-example/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/moliva","download_url":"https://codeload.github.com/moliva/metrics-example/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239576790,"owners_count":19662114,"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":["example","javalin","metrics","micrometer"],"created_at":"2024-11-07T12:49:51.439Z","updated_at":"2025-11-10T00:30:18.665Z","avatar_url":"https://github.com/moliva.png","language":"Java","readme":"# Javalin Micrometer Example\n\nEjemplo de proyecto con un simple recolector de métricas de Micrometer configurado para una app en Javalin.\n\nEl ejemplo muestra una config mínima para tener:\n1) Métricas de la JVM y otros recuros de la instancia local\n2) Métricas custom, configurables desde la app y en relación al dominio específico u otro motivo\n3) Tags comunes a las métricas para identificar la instancia/servicio/etc particular\n4) Exposición del endpoint de métricas utlizando la API propia de Micrometer\n\n## Ejecutar y testear el comportamiento localmente\n\nPara levantar el servicio de ejemplo:\n\n```bash\nmvn clean package exec:java\n```\n\nPara llamar al servicio con la ruta de métricas:\n\n```bash\ncurl localhost:7070/metrics -H \"Authorization: Bearer token\" # cambiar el token por el valor configurado\n```\n\n## Integración con Grafana Cloud\n\nEsta sección es un resumen de la configuración [que pueden encontrar aquí, ver para más detalle](https://grafana.com/docs/grafana-cloud/monitor-infrastructure/integrations/integration-reference/integration-metrics-endpoint/).\n\n1) Entrar a Grafana Cloud, crear un usuario y una cloud propia\n2) Ir a _Connections_ en la barra izquierda y buscar _Metrics Endpoint_ en la barra de búsqueda para agregar nuevas conexiones\n\n![Crear nuevo scrape job](docs/1.png)\n\n3) Click en _Add new scrape job_ e ir a la configuración del trabajo\n4) Configurar el trabajoo de scraping:\n    - Nombre del trabajo con el valor que quieran\n    - _Scrape job URL_ que debe apuntar al endpoint de métricas de su servicio (ej: https://miservicio.com/metrics)\n    - _Type of Authentication Credentials_ en _Bearer_\n    - _Bearer Token_ con el valor configurado del token en su app (en este ejemplo por defecto está en `token`)\n\n![Configuración del scraping job](docs/2.png)\n\n5) Click en _Test Connection_, _Save Scrape Job_ e _Install_\n6) Crear el dashboard\n\nListo, en el nuevo dashboard creado deberían ver las métricas reportadas por el job de scraping. Pueden configurar este dashboard y customizarlo como prefieran.\n\n![Dashboard con métricas](docs/3.png)\n\nEl dashboard creado es customizable y podemos agregar todos los paneles (vistas de Grafana) que querramos.\n\n### Creación de un panel\n\n1) Para crear un panel, debemos ir al dashboard deseado.\n2) Luego, hace click en _Add_ \u003e _Visualization_ en la barra superior derecha del dashboard \n\n![Agregar nuevo panel al dashboard](docs/5.png)\n\n_Nota:_ si no existe la opción, primero deberá clickear sobre el engranaje de _Dashboard settings_ ya que el dashboard debe estar en modo de sólo lectura\n\n3) Al entrar en la herramienta de creación de paneles, elegir las métricas deseadas (ej: jvm_memory_max_bytes)\n4) Click sobre _Run queries_ para empezar a visualizar la data de las métricas seleccionadas\n5) Configurar en la barra derecha las opciones de visualización y descripción del panel\n6) Click en _Save_ y _Apply_ en la barra superior derecha para salir del modo de edición y volver al dashboard con el nuevo panel agregado\n\nEste nuevo panel se puede cambiar de tamaño, posición y otros atributos. Libre para explorar y dependiendo la necesidad y uso que quieran darle al dashboard.\n\n### Importar un panel desde JSON\n\nEn este repositorio pueden encontrar paneles para la memoria de la JVM y la métrica de aplicación que creamos. Ambos paneles se encuentran en formato JSON dentro del directorio de `/panels` y pueden ser usados para importar como se explica a continuación.\n\nPara importar un panel desde un JSON es posible hacer lo siguiente:\n1) Crear un panel vacío y volver al dashboard\n2) Click sobre el _menu_ del panel \u003e _Inspect_ \u003e _Panel JSON_\n\n![Menu de un panel](docs/6.png)\n\n3) Borrar el contenido actual del panel y reemplazarlo por el JSON de un panel conocido\n\n_Nota:_ Antes de hacer esto, ceriorarse que tenemos todas las métricas del panel a importar disponibles en nuestro ambiente de Grafana y que cuentan con los mimos nombres utilizados\n\n![Dashboard con nuevos paneles](docs/4.png)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoliva%2Fmetrics-example","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoliva%2Fmetrics-example","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoliva%2Fmetrics-example/lists"}