io.tornimo:tornimo-spring-cloud

Set of utilities for configuring Tornimo.io connector in the cloud.

License	The Apache Software License, Version 2.0
GroupId	io.tornimo
ArtifactId	tornimo-spring-cloud
Last Version	0.3.1
Release Date	Jul 15, 2019
Type	pom
Description	io.tornimo:tornimo-spring-cloud Set of utilities for configuring Tornimo.io connector in the cloud.
Project URL	https://github.com/tornimo/tornimo-spring-cloud
Source Code Management	http://github.com/tornimo/tornimo-spring-cloud/tree/master

Download tornimo-spring-cloud

Filename	Size
tornimo-spring-cloud-0.3.1.pom	7 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.tornimo/tornimo-spring-cloud/ -->
<dependency>
    <groupId>io.tornimo</groupId>
    <artifactId>tornimo-spring-cloud</artifactId>
    <version>0.3.1</version>
    <type>pom</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.tornimo/tornimo-spring-cloud/
implementation 'io.tornimo:tornimo-spring-cloud:0.3.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.tornimo/tornimo-spring-cloud/
implementation ("io.tornimo:tornimo-spring-cloud:0.3.1")

Apache Buildr

'io.tornimo:tornimo-spring-cloud:pom:0.3.1'

Apache Ivy

<dependency org="io.tornimo" name="tornimo-spring-cloud" rev="0.3.1">
  <artifact name="tornimo-spring-cloud" type="pom" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.tornimo', module='tornimo-spring-cloud', version='0.3.1')
)

Scala SBT

libraryDependencies += "io.tornimo" % "tornimo-spring-cloud" % "0.3.1"

Leiningen

[io.tornimo/tornimo-spring-cloud "0.3.1"]

Dependencies

compile (1)

Group / Artifact	Type	Version
io.tornimo : tornimo-spring-reporter	jar	0.2.1

test (7)

Group / Artifact	Type	Version
org.spockframework : spock-core	jar	1.1-groovy-2.4
org.spockframework : spock-spring	jar	1.1-groovy-2.4
org.codehaus.groovy : groovy-all	jar	2.4.4
net.bytebuddy : byte-buddy	jar	1.8.0
org.objenesis : objenesis	jar	2.5.1
org.hamcrest : hamcrest-core	jar	1.3
org.springframework.boot : spring-boot-starter-test	jar	2.1.6.RELEASE

Project Modules

• tornimo-spring-aws

tornimo-spring-cloud

tornimo-spring-cloud is a set of utilities for configuring micrometer.io to work with tornimo-spring-reporter in the cloud. Check out our repository containing the original tornimo-spring-reporter plugin.

Start Using Tornimo.io

1. If you haven't done so, signup for a free trial account at tornimo.io.
2. After a few minutes, you will receive a link to your dashboard, URL for data ingestion and a token. Use the token and the URL in the configuration step.
3. Add tornimo-spring-reporter to your dependencies.
4. Add one of tornimo-spring-cloud auto configurations to the project.

Base Configuration

management.metrics.export.tornimo.token=b55670fd-ea50-40e4-9cf3-82d2ed46c629  # 1
management.metrics.export.tornimo.host=put.b55670fd.tornimo.io                # 2
management.metrics.export.tornimo.app=example-app                             # 3

1. Token provided during registration at tornimo.io.
2. URL for metrics ingestion, provided during registration.
3. Application name that will be added to the metric path.

Dependency

Add dependency for tornimo-spring-reporter Maven:

<dependency>
    <groupId>io.tornimo</groupId>
    <artifactId>tornimo-spring-reporter</artifactId>
    <version>0.2.1</version>
</dependency>

Gradle:

compile group: 'io.tornimo', name: 'tornimo-spring-reporter', version: '0.2.1'

tornimo-spring-aws

tornimo-spring-aws is a set of utilities that will configure tornimo-spring-reporter to work in the AWS environment. To configure the plugin all you have to do is add this dependency to your maven project:

<dependency>
    <groupId>io.tornimo</groupId>
    <artifactId>tornimo-spring-aws</artifactId>
    <version>0.3.1</version>
</dependency

or for gradle project:

compile group: 'io.tornimo', name: 'tornimo-spring-aws', version: '0.3.1'

AWS Fargate and ECS

AWS Fargate and ECS are services allowing you to run your Docker containers in the cloud. tornimo-spring-aws implements utilities that give you access to the environment information like region, cluster name, task id, etc.

To enable ECS or Fargate support just add one of these lines to the configuration

tornimo.aws-ecs-v2.enabled = true  # 1
tornimo.aws-ecs-v3.enabled = true  # 2

1. Enables AWS ECS or Fargate for version 2 metadata endpoint.
2. Enables AWS ECS or Fargate for version 3 metadata endpoint.

AWS ECS v2 and v3 support Cluster, TaskARN and Revision properties and add them to your metric path. For example your GC metric will look like this:

$app.aws-ecs.$region.$cluster_name.$task_id.jvmGcPause.action.*.cause.*.m1_rate

AWS EC2

You can enable EC2 support by adding this line to the configuration:

tornimo.aws-ec2.enabled = true 

After adding the line, the GC metric will look like this:

$app.aws-ec2.$availability_zone.$instance_type.$instance_id.jvmGcPause.action.*.cause.*.m1_rate

Demo Dashboard

We provide you with a demo dashboard that displays some key metrics. The same dashboard is also provided as a ready to use template.

Tornimo

Versions

Version
0.3.1 Jul 15, 2019
0.3.0 Jul 5, 2019
0.0.1 Jul 4, 2019