+
+
+**JFR**
+
+- 🖨 writes a log file
+- 📥 can be attached to a bug report for later review
+
+
+
+
+**JMX**
+
+- 🩺 connects to a live process
+- 📡 can connect to a remote server
+
+
+
+
+Choose the MBean Server for the Terasology process.
+
+
+This should take you to an Overview with charts showing the process's current resource usage.
+
+
+
+Each MBean represents some value we can monitor.
+The **Filter** control lets us search them by name:
+for example, we can filter by `*fps` to find the entry for the engine's framerate.3
+
+Right-click on its **Number** attribute, choose **Visualize**, and JMC will prompt you about adding it to a chart.
+
+#### Footnotes
+2. At least as of JMC 8.1.0, it seems to treat every process as unique.
+When the current process ends and you connect to a different Terasology process later,
+it reverts to the default configuration.
+3. If your version has something named differently, it's okay.
+We haven't figured out how we're categorizing all these things yet.
+Regardless of the name, as long as it has a Number attached to it, you can chart it.
-## Adding a Connection
+# Adding a Connection
-### Creating a password file
+## Creating a password file
- create `jmxremote.password`
-### Setting the ports
+## Setting the ports
- configuring the process
- `gradle game --jmx-port`
- with Terasology.bat or .sh: set `TERASOLOGY_OPTS`
- with Launcher: ???
-### New Connection in JMC
+## New Connection in JMC
- creating the connection
- your charts should now be persistent
# Remote Use
-- same process as “adding a connection”
+- set up jmx port, create Connection
- use a SSH tunnel?
diff --git a/docs/_media/JMC/JMC JMX Console - Default.halfsize.webp b/docs/_media/JMC/JMC JMX Console - Default.halfsize.webp
new file mode 100644
index 0000000000000000000000000000000000000000..ea8515d29b271317e60f7bd32722795b230cd445
GIT binary patch
literal 27074
zcmV(zK<2+vNk&GxX#fCMMM6+kP&iDjX#fB(SHVgEO-O7TNs=TevSz3I6z9LeT|J)#
z5&fS4bL}E)tvF=w2cv+p6+j`p1z3IMn?(f>zXsULk1C?*MZckf%1>SZe?g1es_jL!
z?WJ{J*9HNK%moAppb9FeRTzN3e{6^AV(WnX{R3@vHmr4-!OIeG1o&J3Fzq=r1B-PW
zoadY~u%7EUIA>;Ht#urm^E_u(o*qYX=A3z~6^|t6dCshr