Google Cloud Metrics Library

Wrapper for Google Analytics reporting of usage metrics.

License	The Apache License, Version 2.0
Categories	Reporting Business Logic Libraries
GroupId	com.google.cloud
ArtifactId	reporting-lib
Last Version	1.0
Release Date	Sep 3, 2015
Type	jar
Description	Google Cloud Metrics Library Wrapper for Google Analytics reporting of usage metrics.
Project URL	http://github.com/google/cloud-reporting
Source Code Management	http://github.com/google/cloud-reporting

Download reporting-lib

Filename	Size
reporting-lib-1.0.pom
reporting-lib-1.0.jar	13 KB
reporting-lib-1.0-sources.jar	11 KB
reporting-lib-1.0-javadoc.jar	51 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.google.cloud/reporting-lib/ -->
<dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>reporting-lib</artifactId>
    <version>1.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.google.cloud/reporting-lib/
implementation 'com.google.cloud:reporting-lib:1.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.google.cloud/reporting-lib/
implementation ("com.google.cloud:reporting-lib:1.0")

Apache Buildr

'com.google.cloud:reporting-lib:jar:1.0'

Apache Ivy

<dependency org="com.google.cloud" name="reporting-lib" rev="1.0">
  <artifact name="reporting-lib" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.google.cloud', module='reporting-lib', version='1.0')
)

Scala SBT

libraryDependencies += "com.google.cloud" % "reporting-lib" % "1.0"

Leiningen

[com.google.cloud/reporting-lib "1.0"]

Dependencies

compile (5)

Group / Artifact	Type	Version
com.google.code.findbugs : jsr305	jar	3.0.0
org.apache.httpcomponents : httpasyncclient	jar	4.1
com.google.guava : guava	jar	18.0
com.google.inject : guice	jar	3.0
cglib : cglib	jar	2.2

test (3)

Group / Artifact	Type	Version
org.easymock : easymock	jar	3.3.1
junit : junit	jar	4.12
com.google.truth : truth	jar	0.25

Project Modules

There are no modules declared in this project.

Google Cloud Metrics Library

This library wraps the creation and sending of HTTPS POST requests to the Google Analytics API for reporting end-user events, suitable for usage metrics. The event object model is tailored accordingly.

Usage

Create and hold an instance of MetricsSender or AsyncMetricsSender. This library uses Guice for dependency injection, in particular to inject the Google Analytics ID. A non-DI constructor is also available.

Whenever a user event occurs that needs to be recorded, create an Event object and invoke the send() method of your Sender object.

Each instance of MetricsSender and AsyncMetricsSender is expected to be long-lived; creating a new instance for each request imposes unnecessary overhead, especially in the case of AsyncMetricsSender.

To maintain user privacy, the fields of the Event object should never include personally identifying information.

Development

gradlew is a script that invokes a wrapper to allow downloading and running gradle on computers that do not have the package already installed. To build and test your changes simply run:

./gradlew build -x sign
./gradlew test -x sign

This skips the signing step, which is required when releasing full versions.

License

(The Apache v2 License)

Copyright 2015 Google Inc. All Rights Reserved.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Google

Google ❤️ Open Source

Versions

Version
1.0 Sep 3, 2015