{"id":19226591,"url":"https://github.com/alonsodomin/kamon-cloudwatch","last_synced_at":"2025-04-21T00:32:53.543Z","repository":{"id":35179318,"uuid":"105135994","full_name":"alonsodomin/kamon-cloudwatch","owner":"alonsodomin","description":"Kamon extension to ship Kamon metrics to AWS Cloudwatch","archived":false,"fork":false,"pushed_at":"2024-02-28T07:15:44.000Z","size":734,"stargazers_count":7,"open_issues_count":23,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-02-28T08:29:16.936Z","etag":null,"topics":["aws","aws-cloudwatch","cloudwatch","kamon","metrics","metrics-gathering"],"latest_commit_sha":null,"homepage":"","language":"Scala","has_issues":false,"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/alonsodomin.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}},"created_at":"2017-09-28T10:38:42.000Z","updated_at":"2024-02-28T08:29:20.557Z","dependencies_parsed_at":"2024-02-28T08:29:20.299Z","dependency_job_id":"d747bbf3-2433-4f53-b5fd-6d1b1c746610","html_url":"https://github.com/alonsodomin/kamon-cloudwatch","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alonsodomin%2Fkamon-cloudwatch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alonsodomin%2Fkamon-cloudwatch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alonsodomin%2Fkamon-cloudwatch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alonsodomin%2Fkamon-cloudwatch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alonsodomin","download_url":"https://codeload.github.com/alonsodomin/kamon-cloudwatch/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223842928,"owners_count":17212484,"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":["aws","aws-cloudwatch","cloudwatch","kamon","metrics","metrics-gathering"],"created_at":"2024-11-09T15:19:23.429Z","updated_at":"2024-11-09T15:19:24.093Z","avatar_url":"https://github.com/alonsodomin.png","language":"Scala","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kamon AWS Cloudwatch Extension\n\n[![Build Status](https://travis-ci.org/alonsodomin/kamon-cloudwatch.svg?branch=master)](https://travis-ci.org/alonsodomin/kamon-cloudwatch)\n[![GitHub release](https://img.shields.io/github/tag/alonsodomin/kamon-cloudwatch.svg)](https://github.com/alonsodomin/kamon-cloudwatch/releases)\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.github.alonsodomin/kamon-cloudwatch_2.12/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.github.alonsodomin/kamon-cloudwatch_2.12)\n[![Mergify Status](https://img.shields.io/endpoint.svg?url=https://gh.mergify.io/badges/alonsodomin/kamon-cloudwatch\u0026style=flat)](https://mergify.io)\n\n## Overview\n\nA simple [Kamon](https://github.com/kamon-io/Kamon) extension to ship metrics data to Cloudwatch using Amazon's async client.\n\n_**Note:** This project has been initially forked from [Timeout's kamon-cloudwatch](https://github.com/timeoutdigital/kamon-cloudwatch) but evolved separately as the original one has fallen out of maintenance._\n\n## Version Compatibility Matrix\n\nThe following table maps Kamon core version with the version of this library:\n\n| Kamon Core | Kamon CloudWatch | Scala          | JDK  |\n|-----------:| ----------------:| --------------:|-----:|\n|      1.0.0 |            1.0.0 | 2.10,2.11,2.12 | 1.8+ |\n|      2.0.0 |            1.1.x | 2.11,2.12,2.13 | 1.8+ |\n\n## Getting Started\n\nAdd library dependency to your `build.sbt`\n\n```scala\nlibraryDependencies += \"com.github.alonsodomin\" %% \"kamon-cloudwatch\" % \"\u003cversion\u003e\"\n```\n\nThe module will be loaded automatically and you should see \"_Starting the Kamon CloudWatch extension_\" message in your logs output.\n\n\u003e **Note:** Be sure the box in which this is going to be used, has the proper access credentials to send data to AWS CloudWatch. The preferred approach would be to either use an _InstanceProfile_ or roles in the case of ECS/Docker Containers. Another way would be to have the environment variables `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` set correctly.\n\n### Kamon 1.0 users\n\nIf using Kamon 1.x, you will need to register it manually during application startup:\n\n```scala\nval reporter = new CloudWatchReporter()\nKamon.addReporter(reporter)\n```\n\n## Configuration\n\nYou can configure the module behaviour by overriding any of the following settings in your `application.conf` file:\n\n```\nkamon {\n  cloudwatch {\n\n    # namespace is the AWS Metrics custom namespace\n    namespace = \u003capplication name\u003e\n    \n    # (Optional) AWS region, on ec2 region is fetched by getCurrentRegion command\n    region = eu-west-1\n\n    # batch size of data when send to Cloudwatch. Default: 20\n    batch-size = 20\n\n    # how many threads will be assigned to the pool that does the shipment of metrics. Default: 5\n    async-threads = 5\n    \n    # whether to add Kamon environment tags to each of the metrics. Default: false\n    include-environment-tags = false\n\n    # explicit aws access key and secret definition (optional)\n    # if not specified values fetched from one of the followings\n    #   * AWS_PROFILE env variable\n    #   * AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY env variables\n    #   * Amazon EC2 Instance Metadata\n    # access-key-id = \"\"\n    # secret-access-key = \"\"\n\n  }\n}\n```\n\n# AWS Cloudwatch Example\n- log on to Cloudwatch, the metrics will be appearing on 'Custom namespaces' section under \"Metrics\" menu, i.e.:\n![alt text](https://github.com/alonsodomin/kamon-cloudwatch/blob/master/doc/cloudwatch-metrics.jpg \"what has showed up in Cloudwatch\")\n\n# License\n- [Apache V2](https://github.com/alonsodomin/kamon-cloudwatch/blob/master/LICENSE \"MIT\")\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falonsodomin%2Fkamon-cloudwatch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falonsodomin%2Fkamon-cloudwatch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falonsodomin%2Fkamon-cloudwatch/lists"}