Skip to content

Commit

Permalink
added screenshots, added CHANGELOG.md
Browse files Browse the repository at this point in the history
  • Loading branch information
PeterPaul-Perfana committed May 3, 2024
1 parent 525a3cb commit ba19de8
Show file tree
Hide file tree
Showing 6 changed files with 29 additions and 23 deletions.
4 changes: 2 additions & 2 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ jobs:

steps:
- name: Checkout repo
uses: actions/checkout@v3
uses: actions/checkout@v4
with:
fetch-depth: 0

Expand All @@ -41,4 +41,4 @@ jobs:
- uses: ncipollo/release-action@v1
with:
artifacts: "target/jfr-exporter-${{ env.GIT_TAG_NAME }}.jar"
body: "Release ${{ env.GIT_TAG_NAME }}"
bodyFile: CHANGELOG.md
18 changes: 18 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# Change log jfr-exporter

### v0.4.0: May 2024
* Added new events:
* Native Memory
* Container CPU and memory
* Thread context switch rate
* Updated dashboard with new events
* Improved dashboard, application selection is working for all panels

### v0.3.0: January 2024
* Added new events: Java Monitor waits and enters, Network read/write
* New dashboard with new events

### v0.3.1: April 2024
* Make use of buffer to send events in batches
* Make event handling more robust by catching exceptions
* Added disableStackTraces option to limit the amount of stacktrace data
30 changes: 9 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,12 @@ Java Monitor waits and enters:
Network reads and writes:
![dashboard overview 5](images/dashboard-5.jpg)

Native memory usage:
![dashboard overview nmt](images/dashboard-native-memory.jpg)

Container CPU throttle:
![dashboard cpu throttle](images/dashboard-container-cpu-throttle.jpg)

For some events stacktraces are present, such as where in the code a big memory allocation took place.
(see screenshot below)

Expand All @@ -45,7 +51,7 @@ To use JfrExporter:

## Download

Direct [download version 0.3.1](https://github.com/perfana/jfr-exporter/releases/download/0.3.1/jfr-exporter-0.3.1.jar)
Direct [download version 0.4.0](https://github.com/perfana/jfr-exporter/releases/download/0.4.0/jfr-exporter-0.4.0.jar)

Download the latest release from the [releases page](https://github.com/perfana/jfr-exporter/releases).

Expand Down Expand Up @@ -125,7 +131,7 @@ Example of a big memory allocation stacktrace:

## Native Memory

To see the native memory usage, enable NMT on the process command line by adding:
To see the native memory usage, enable Native Memory Tracking (NMT) on the process command line by adding:

-XX:NativeMemoryTracking=summary

Expand All @@ -136,7 +142,7 @@ A Grafana dashboard can be imported to view the JFR metrics.
Import the dashboard in the `dashboards` directory into Grafana and
connect to an InfluxDB datasource that points to the `jfr` database.

For version 0.3.0 and above use dashboard `jfr-dashboard-export-share-0.3.json`.
For version 0.4.0 and above use dashboard `jfr-dashboard-export-share-0.4.json`.

## Troubleshoot

Expand All @@ -146,21 +152,3 @@ For tracing (more debug logging) use: `-Dio.perfana.jfr.trace=true`

Debug and tracing will output a lot of data, so only use for troubleshooting.

# Releases

### v0.4.0: May 2024
* Added new events:
* Native Memory
* Container CPU and memory
* Thread context switch rate
* Updated dashboard with new events
* Improved dashboard, application selection is working for all panels

### v0.3.0: January 2024
* Added new events: Java Monitor waits and enters, Network read/write
* New dashboard with new events

### v0.3.1: April 2024
* Make use of buffer to send events in batches
* Make event handling more robust by catching exceptions
* Added disableStackTraces option to limit the amount of stacktrace data
Binary file added images/dashboard-container-cpu-throttle.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/dashboard-container-memory-failures.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/dashboard-native-memory.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit ba19de8

Please sign in to comment.