AppVeyor | Travis |
---|---|
Package | Dev Release | Pre Release | Latest Release |
---|---|---|---|
App.Metrics | |||
App.Metrics.Extensions.Mvc | |||
App.Metrics.Extensions.Middleware | |||
App.Metrics.Formatters.Json |
App Metrics is an open-source and cross-platform .NET library used to record metrics within an application. App Metrics can run on .NET Core or on the full .NET framework also supporting .NET 4.5.2. App Metrics abstracts away the underlaying repository of your Metrics for example InfluxDB, Graphite, Elasticsearch etc, by sampling and aggregating in memory and providing extensibility points to flush metrics to a repository at a specified interval. For pre .NET Core web applications see AppMetrics.Owin
App Metrics provides various metric types to measure things such as the rate of requests, counting the number of user logins over time, measure the time taken to execute a database query, measure the amount of free memory and so on. Metrics types supported are Gauges, Counters, Meters, Histograms and Timers and Application Performance Indexes Apdex.
For metric reporting capabilities see the reporting repo.
App.Metrics
includes an Exponentially Forward Decaying, Sliding Window and Algorithm R reservoir implementations, for additional reservoir sampling see the reservoir repo. For more details on reservoir sampling see the docs.
App Metrics also provides a health checking system allowing you to monitor the health of your application through user defined checks.
Grab the dashboard here
Grab the dashboard here
- Download and install InfluxDB. Runs well on Windows using
Bash on Windows on Ubuntu
- Download and install Grafana, then import App.Metrics web dashboard
- Drop in the
App.Metrics.Extensions.Mvc
andApp.Metrics.Extensions.Reporting.InfluxDB
nuget packages into your web application. - Create a new InfluxDB Database. Keep note of this for configuring the InfluxDB reporter in your web application
- Add App.Metrics configuration to the
Startup.cs
of your web application, including the InfluxDB reporter configuration. You might want to check out the Sandbox or Sample projects if you get stuck - Run your app and Grafana at visit
http://localhost:3000
AppVeyor and Travis CI builds are triggered on commits and PRs to dev
and master
branches.
See the following for build arguments and running locally.
Configuration | Description | Default | Environment | Required |
---|---|---|---|---|
BuildConfiguration | The configuration to run the build, Debug or Release | Release | All | Optional |
PreReleaseSuffix | The pre-release suffix for versioning nuget package artifacts e.g. beta |
ci | All | Optional |
CoverWith | DotCover or OpenCover to calculate and report code coverage, None to skip. When not None, a coverage file and html report will be generated at ./artifacts/coverage |
OpenCover | Windows Only | Optional |
SkipCodeInspect | false to run ReSharper code inspect and report results, true to skip. When true, the code inspection html report and xml output will be generated at ./artifacts/resharper-reports |
false | Windows Only | Optional |
BuildNumber | The build number to use for pre-release versions | 0 | All | Optional |
Run build.ps1
from the repositories root directory.
.\build.ps1
With Arguments
.\build.ps1 --ScriptArgs '-BuildConfiguration=Release -PreReleaseSuffix=beta -CoverWith=OpenCover -SkipCodeInspect=false -BuildNumber=1'
Run build.sh
from the repositories root directory. Code Coverage reports are now supported on Linux and OSX, it will be skipped running in these environments.
.\build.sh
With Arguments
.\build.sh --ScriptArgs '-BuildConfiguration=Release -PreReleaseSuffix=beta -BuildNumber=1'
Nuget packages won't be generated on non-windows environments by default.
Unfortunately there is currently no way out-of-the-box to conditionally build & pack a project by framework. Because
App.Metrics
packages target.NET 4.5.2
as well asdotnet standard
there is a work around in the build script to forcedotnet standard
on build but no work around for packaging on non-windows environments.
App.Metrics includes bencmarking using BenchmarkDotNet. You can find the benchmark results here.
To run, fron the solution's root:
cd .\benchmarks\App.Metrics.Benchmarks.Runner\
dotnet run -c "Release"
You'll then be prompted to choose a benchmark to run which will output a markdown file with the result in directory .\benchmarks\App.Metrics.Benchmarks.Runner\BenchmarkDotNet.Artifacts\results
.
Alternatively, you can run the same benchmarks from visual studio using XUnit in the benchmark project.
See the contribution guidlines for details.
Thanks for providing free open source licensing
This library is release under Apache 2.0 License ( see LICENSE ) Copyright (c) 2016 Allan Hardy
See LICENSE
App Metrics is based on the Metrics.NET library, and at the moment uses the same reservoir sampling code from the original library which is a port of the Java Dropwizard Metrics library.
Metrics.NET Licensed under these terms: "Metrics.NET is release under Apache 2.0 License Copyright (c) 2014 Iulian Margarintescu" see LICENSE
Dropwizard Metrics Licensed under these terms*: "Copyright (c) 2010-2013 Coda Hale, Yammer.com Published under Apache Software License 2.0, see LICENSE"