{"type":"doc","content":[{"type":"paragraph","content":[{"text":"As of version 2.6.4 Weave supports metrics, which are counters, gauges and histograms that can be used to monitor the performance of the Weave server.","type":"text"}]},{"type":"paragraph","content":[{"text":"The metrics can be published to one of four different metrics “databases”, ","type":"text"},{"text":"Prometheus","type":"text","marks":[{"type":"link","attrs":{"href":"https://prometheus.io/"}}]},{"text":", ","type":"text"},{"text":"InfluxDB","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.influxdata.com/"}}]},{"text":", ","type":"text"},{"text":"Datadog","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.datadoghq.com/"}}]},{"text":" and ","type":"text"},{"text":"JAMon","type":"text","marks":[{"type":"link","attrs":{"href":"https://cohgawiki.atlassian.net/wiki/x/iYYx"}}]},{"text":", or not published at all (which removes the overhead of collecting the metrics if you don’t intend to use them).","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Long Term Monitoring","type":"text"}]},{"type":"paragraph","content":[{"text":"Prometheus, InfluxDB and Datadog provide long term monitoring because they use a database and the metrics are stored in the database so they are not lost after a service or system restart.","type":"text"}]},{"type":"paragraph","content":[{"text":"These tools provide basic graphing, but are primarily for collecting the metrics over a long period; another tool would be used to display and monitor that information, for example Grafana ","type":"text"},{"text":"https://grafana.com/","type":"text","marks":[{"type":"link","attrs":{"href":"https://grafana.com/"}}]},{"text":". A basic dashboard for Grafana that uses Prometheus is available for ","type":"text"},{"text":"import to Grafana from here","type":"text","marks":[{"type":"link","attrs":{"href":"https://cohgawiki.atlassian.net/wiki/download/attachments/1286995969/Weave+Metrics+Dashboard+v1.2.2-1663209629560.json?version=1"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Short Term Monitoring","type":"text"}]},{"type":"paragraph","content":[{"text":"JAMon does short term monitoring but not monitoring of your system over the long term. The monitoring is described as short term because once the Weave services are restarted, the metrics will be lost as they are cleared after a restart.","type":"text"}]},{"type":"paragraph","content":[{"text":"The JAMon metrics registry is for sites that don't have one of the proper metrics registries but want to be able to at least see what the metrics are doing. If you want to make use the metrics to their full potential, you should use one of the other registries.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Installation","type":"text"}]},{"type":"paragraph","content":[{"text":"If you perform an upgrade to 2.6.4 from a previous 2.6 release then the metrics will not be installed.","type":"text"}]},{"type":"paragraph","content":[{"text":"You need to perform a clean install of 2.6.4 and choose to install one of the metrics database providers during installation from the available Extensions, or, after you upgrade to 2.6.4 re-run the 2.6.4 installer (not the updater), uncheck the Main Components and then choose the metrics database provider you wish to utilise from the available Extensions.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"There may be an issue with the installer and you should also click on the System Metrics check box to ensure all the components are installed.","type":"text"}]},{"type":"paragraph","content":[{"text":"That is you should make sure that the System Metrics box has a check mark and not a green square before continuing, otherwise the required metrics plugins will not be installed.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"You can only install a single registry provider, JAMon, Datadog, InfluxDB or Prometheus at a time.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you have previously installed one of the above registries you should remove the corresponding plugin before installing another or the metrics recording will not work.","type":"text"}]},{"type":"paragraph","content":[{"text":"The registry plugins will be named ","type":"text"},{"text":"com.cohga.server.metric.registry.*_x.y.z.jar","type":"text","marks":[{"type":"code"}]},{"text":", where ","type":"text"},{"text":"*","type":"text","marks":[{"type":"code"}]},{"text":" is either ","type":"text"},{"text":"jamon","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"datadog","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"influxdb","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"prometheus","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"If you do not see the metrics you expect check if there is more than one plugin with that above names.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that the ","type":"text"},{"text":"com.cohga.server.metric.registry.api_x.y.z.jar","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"com.cohga.server.metric.registry.micrometer_x.y.z.jar","type":"text","marks":[{"type":"code"}]},{"text":" plugins should always remain, along with the other ","type":"text"},{"text":"com.cohga.server.metric.*_x.y.z.jar","type":"text","marks":[{"type":"code"}]},{"text":" files.","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":740,"id":"b4012e77-a904-45d2-9b9e-9f6ddfc998dd","collection":"contentId-1286995969","type":"file","height":628}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configuration","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"JAMon","type":"text"}]},{"type":"paragraph","content":[{"text":"JAMon is an internal metrics database that stores the metrics and makes them available via the existing ","type":"text"},{"text":"Weave server status page","type":"text","marks":[{"type":"link","attrs":{"href":"https://cohgawiki.atlassian.net/wiki/x/iYYx"}}]},{"text":" (under the Timing Summary page). JAMon requires no configuration.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Prometheus","type":"text"}]},{"type":"paragraph","content":[{"text":"Out of the box, the Prometheus database requires no configuration to start it working, and it then presents the available metrics for collection from the ","type":"text"},{"text":"/weave/metrics","type":"text","marks":[{"type":"code"}]},{"text":" URL. To utilise the metrics you need to point your Prometheus server to access that URL to periodically collect the metrics from the Weave server.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following is a working prometheus.yml configuration file that can be used with a Prometheus server, you just need to change to the Weave server hostname and to the port that Weave can be access at. Note you may need to change the ","type":"text"},{"text":"scheme attribute","type":"text","marks":[{"type":"link","attrs":{"href":"https://prometheus.io/docs/prometheus/latest/configuration/configuration/"}}]},{"text":" if you’re not directly accessing Weave over http and are using https.","type":"text"},{"type":"hardBreak"},{"text":"While this example is enough to get Prometheus working with a Weave server and can serve as a complete Prometheus server configuration file you would likely include more than this, this is intended to just show what is required to add a connection to a Weave server.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"scrape_configs:\n - job_name: 'weave'\n scrape_interval: 1m\n metrics_path: '/weave/metrics'\n static_configs:\n - targets:\n - :","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If you’re going to use a security.xml file from a previous version of Weave it may not include an entry for the Prometheus /metrics endpoint, if this is the case add the following entry to the filterInvocationDefinitionSource property in the filterChainProxy, after PATTERN_TYPE_APACHE_ANT but before /**=httpSessionContextIntegrationFilter,logoutFilter,...","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"/metrics=#NONE#","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"paragraph","content":[{"text":"The default ","type":"text"}]},{"type":"paragraph","content":[{"text":"Other configuration options:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"descriptions","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Should meter descriptions be sent to Prometheus? Default is ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", set to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":" to minimise the amount of data sent on each scrape","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"step","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The step size to use in computing windowed statistics like max. The default is 1 minute. To get the most out of these statistics, align the step interval to be close to your scrape interval.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The formats accepted are based on the ISO-8601 duration format ","type":"text"},{"text":"PnDTnHnMn.nS","type":"text","marks":[{"type":"code"}]},{"text":" with days considered to be exactly 24 hours, e.g","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"PT20.345S\" -- parses as \"20.345 seconds\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"PT15M\" -- parses as \"15 minutes\" (where a minute is 60 seconds)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"PT10H\" -- parses as \"10 hours\" (where an hour is 3600 seconds)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"P2D\" -- parses as \"2 days\" (where a day is 24 hours or 86400 seconds)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"P2DT3H4M\" -- parses as \"2 days, 3 hours and 4 minutes\"","type":"text"}]}]}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Datadog","type":"text"}]},{"type":"paragraph","content":[{"text":"Datadog must at least be configured to provide an ","type":"text"},{"text":"apiKey","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"applicationKey","type":"text","marks":[{"type":"code"}]},{"text":", but it also supports a number of other configuration options.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\t\n\t\tINCLUDE_YOUR_API_KEY_HERE\n\t\tINCLUDE_YOUR_APPLICATION_KEY_HERE\n\t\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Other configuration options:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"hostTag","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The tag that will be mapped to \"host\" when shipping metrics to datadog, default is no tag","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"uri","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"URL to push metrics to, default is ","type":"text"},{"text":"https://app.datadoghq.com","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"descriptions","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Should meter descriptions be sent to Datadog? Default is ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", set to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":" to minimise the amount of data sent on each scrape","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"step","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The step size (reporting frequency) to use. The default is 1 minute.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The formats accepted are based on the ISO-8601 duration format ","type":"text"},{"text":"PnDTnHnMn.nS","type":"text","marks":[{"type":"code"}]},{"text":" with days considered to be exactly 24 hours, e.g","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"PT20.345S\" -- parses as \"20.345 seconds\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"PT15M\" -- parses as \"15 minutes\" (where a minute is 60 seconds)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"PT10H\" -- parses as \"10 hours\" (where an hour is 3600 seconds)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"P2D\" -- parses as \"2 days\" (where a day is 24 hours or 86400 seconds)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"P2DT3H4M\" -- parses as \"2 days, 3 hours and 4 minutes\"","type":"text"}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"enabled","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If publishing is enabled. Default is ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"numThreads","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The number of threads to use with the scheduler. The default is 2 threads.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"connectTimeout","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The connection timeout for requests to the backend. The default is 1 second.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"readTimeout","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The read timeout for requests to the backend. The default is 10 seconds.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"batchSize","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The number of measurements per request to use for the backend. If more measurements are found, then multiple requests will be made. The default is 10,000.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"InfluxDB","type":"text"}]},{"type":"paragraph","content":[{"text":"InfluxDB must be configured to at least provide a ","type":"text"},{"text":"userName","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"password","type":"text","marks":[{"type":"code"}]},{"text":". InfluxDB also supports a number of other configuration options.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\t\n\t\tINCLUDE_YOUR_USERNAME_KEY_HERE\n\t\tINCLUDE_YOUR_PASSWORD_KEY_HERE\n\t\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Other configuration options:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"db","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The db to send metrics to. Defaults to \"mydb\".","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"consistency","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sets the write consistency for each point. The Influx default is 'one'. Must be one of 'any', 'one', 'quorum', or 'all'. Only available for InfluxEnterprise clusters.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"retentionPolicy","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Influx writes to the DEFAULT retention policy if one is not specified.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"retentionDuration","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Time period for which influx should retain data in the current database (e.g. 2h, 52w).","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"retentionReplicationFactor","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"How many copies of the data are stored in the cluster. Must be 1 for a single node instance.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"retentionShardDuration","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The time range covered by a shard group (e.g. 2h, 52w).","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"uri","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The URI for the Influx backend. The default is ","type":"text"},{"text":"http://localhost:8086","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"compressed","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"if metrics publish batches should be GZIP compressed, default is ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"autoCreateDb","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"if Micrometer should check if ","type":"text"},{"text":"db","type":"text","marks":[{"type":"code"}]},{"text":" exists before attempting to publish metrics to it, creating it if it does not exist.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"step","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The step size (reporting frequency) to use. The default is 1 minute.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The formats accepted are based on the ISO-8601 duration format ","type":"text"},{"text":"PnDTnHnMn.nS","type":"text","marks":[{"type":"code"}]},{"text":" with days considered to be exactly 24 hours, e.g","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"PT20.345S\" -- parses as \"20.345 seconds\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"PT15M\" -- parses as \"15 minutes\" (where a minute is 60 seconds)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"PT10H\" -- parses as \"10 hours\" (where an hour is 3600 seconds)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"P2D\" -- parses as \"2 days\" (where a day is 24 hours or 86400 seconds)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"P2DT3H4M\" -- parses as \"2 days, 3 hours and 4 minutes\"","type":"text"}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"enabled","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If publishing is enabled. Default is ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"numThreads","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The number of threads to use with the scheduler. The default is 2 threads.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"connectTimeout","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The connection timeout for requests to the backend. The default is 1 second.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"readTimeout","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The read timeout for requests to the backend. The default is 10 seconds.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"batchSize","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The number of measurements per request to use for the backend. If more measurements are found, then multiple requests will be made. The default is 10,000.","type":"text"}]}]}]}]}]}],"version":1}

Browser not supported