Confluence

Auto-Detection

Built-in Metrics

Bleemeo monitors Confluence through automatic service detection and JMX metrics collection for wiki performance.

Auto-Detection

Glouton automatically detects Confluence instances running on the system.

To enable metrics gathering, the Bleemeo agent must be installed with JMX enabled. See Java JMX Metrics for setup details.

Confluence must also expose JMX over a TCP port. Follow the Live Monitoring Using the JMX Interface guide.

Summary for unauthenticated access:

• Add -Dcom.sun.management.jmxremote.port=3333 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false to the JVM. The default Confluence startup script accepts these from CATALINA_OPTS or JAVA_OPTS environment variables.

Caution

This allows unauthenticated access. Ensure no untrusted access to this port is possible, or set up authenticated JMX access.

If auto-detected parameters are incorrect, you can override them manually.

Linux

sudo tee /etc/glouton/conf.d/99-confluence.conf > /dev/null << 'EOF'
service:
  # For a Confluence running outside a container
  - type: "confluence"
    address: "127.0.0.1"
    port: 8090
    jmx_port: 3333
    jmx_username: "monitorRole" # by default, no authentication is done
    jmx_password: "secret"

  # For an additional Confluence running outside a container
  - type: "confluence"
    instance: "NAME_ASSOCIATED_WITH_YOUR_ADDITIONAL_SERVICE"
    address: "127.0.0.1"
    port: 8091
    jmx_port: 3334
    jmx_username: "monitorRole" # by default, no authentication is done
    jmx_password: "secret"

  # For a Confluence running in a Docker container
  - type: "confluence"
    instance: "CONTAINER_NAME"
    address: "172.17.0.2"
    port: 8090
    jmx_port: 3333
    jmx_username: "monitorRole" # by default, no authentication is done
    jmx_password: "secret"
EOF

Windows

Create or edit C:\ProgramData\glouton\conf.d\99-confluence.conf:

service:
  # For a Confluence running outside a container
  - type: "confluence"
    address: "127.0.0.1"
    port: 8090
    jmx_port: 3333
    jmx_username: "monitorRole" # by default, no authentication is done
    jmx_password: "secret"

  # For an additional Confluence running outside a container
  - type: "confluence"
    instance: "NAME_ASSOCIATED_WITH_YOUR_ADDITIONAL_SERVICE"
    address: "127.0.0.1"
    port: 8091
    jmx_port: 3334
    jmx_username: "monitorRole" # by default, no authentication is done
    jmx_password: "secret"

  # For a Confluence running in a Docker container
  - type: "confluence"
    instance: "CONTAINER_NAME"
    address: "172.17.0.2"
    port: 8090
    jmx_port: 3333
    jmx_username: "monitorRole" # by default, no authentication is done
    jmx_password: "secret"

Glouton automatically detects configuration changes.

Built-in Metrics

Metric	Description
service_status	Status of Confluence
confluence_db_query_time	Database query time in seconds
confluence_jvm_gc	Number of garbage collections per second
confluence_jvm_gc_utilization	Garbage collection utilization in percent
confluence_jvm_heap_used	Heap memory used in bytes
confluence_jvm_non_heap_used	Non-heap memory used in bytes
confluence_last_index_time	Time of last indexing task in seconds
confluence_queued_error_mails	Number of error mails queued
confluence_queued_index_tasks	Number of indexing tasks queued
confluence_queued_mails	Number of mails queued
confluence_request_time	Average time of request in seconds
confluence_requests	Number of requests per second