---
# System prepended metadata

title: Oreo EMF Metrics Utility

---

# Oreo EMF Metrics Utility

This package is an example Java library package using the HappierTrails build system. It provides a basic Apache Ant `build.xml` that imports the additional Ant scripts `happytrails.xml` and `happier-trails.xml`.

### How to use
- Build `IAMIntelOreoMetricUtils` from live
- Inject `com.amazon.iaminteloreometricutils.metrics.MetricsContextFactory` to client class using dagger. Remember to configure default dimensions if needed. [Example](https://code.amazon.com/packages/IAMIntelOreoInvokeWorkflowLambda/blobs/a09a22d2c8fb29cbecaaa7091380ef92ab6ef58d/--/src/com/amazon/iaminteloreoinvokeworkflowlambda/dagger/HandlerModule.java#L117-L122)
- Use try with resource block to get `MetricContext` per client. Discard after publishing metrics. [Example](https://code.amazon.com/packages/IAMIntelOreoInvokeWorkflowLambda/blobs/a09a22d2c8fb29cbecaaa7091380ef92ab6ef58d/--/src/com/amazon/iaminteloreoinvokeworkflowlambda/handler/Handler.java#L68)
- Each dimension will result in a new column on CW. Custom dimensions set for `MetricsContext` will be lost when it goes out of scope. But default dimensions will be preserved from `MetricsContextFactory`.

#References
* Apache Ant Manual: https://ant.apache.org/manual/index.html
* Debugging Apache Ant Scripts: https://ant.apache.org/problems.html
* JUnit5 User Guide: https://junit.org/junit5/docs/current/user-guide/
* JUnit5 Apache Ant Task: https://ant.apache.org/manual/Tasks/junitlauncher.html
* HappierTrails Wiki: https://w.amazon.com/bin/view/BrazilBuildSystem/HappierTrails/
* HappierTrails Properties Guide: https://w.amazon.com/index.php/BrazilBuildSystem/HappierTrails/PropertiesGuide