Add logs documentation

activemq_xml/README.md

@@ -30,6 +30,30 @@ To configure this check for an Agent running on a host:
 
 2. [Restart the Agent][117].
 
+##### Log collection
+
+1. Collecting logs is disabled by default in the Datadog Agent, enable it in your `datadog.yaml` file:
+
+   ```yaml
+   logs_enabled: true
+   ```
+
+2. Add this configuration block to your `activemq_xml.d/conf.yaml` or `activemq.d/conf.yaml` file to start collecting your ActiveMQ logs:
+
+   ```yaml
+   logs:
+     - type: file
+       path: "<ACTIVEMQ_BASEDIR>/data/activemq.log"
+       source: activemq
+       service: "<SERVICE_NAME>"
+     - type: file
+       path: "<ACTIVEMQ_BASEDIR>/data/audit.log"
+       source: activemq
+       service: "<SERVICE_NAME>"
+   ```
+
+3. [Restart the Agent][7].
+
 <!-- xxz tab xxx -->
 <!-- xxx tab "Containerized" xxx -->
 

activemq_xml/assets/configuration/spec.yaml

@@ -50,3 +50,13 @@ files:
         example: [<SUBSCRIBER_1>, <SUBSCRIBER_2>]
     - template: instances/http
     - template: instances/default
+  - template: logs
+    example:
+    - type: file
+      path: <ACTIVEMQ_BASEDIR>/data/activemq.log
+      source: activemq
+      service: <SERVICE_NAME>
+    - type: file
+      path: <ACTIVEMQ_BASEDIR>/data/audit.log
+      source: activemq
+      service: <SERVICE_NAME>

activemq_xml/datadog_checks/activemq_xml/data/conf.yaml.example

@@ -385,3 +385,28 @@ instances:
     ## This is useful for cluster-level checks.
     #
     # empty_default_hostname: false
+
+## Log Section
+##
+## type - required - Type of log input source (tcp / udp / file / windows_event)
+## port / path / channel_path - required - Set port if type is tcp or udp.
+##                                         Set path if type is file.
+##                                         Set channel_path if type is windows_event.
+## source  - required - Attribute that defines which Integration sent the logs.
+## encoding - optional - For file specifies the file encoding, default is utf-8, other
+##                       possible values are utf-16-le and utf-16-be.
+## service - optional - The name of the service that generates the log.
+##                      Overrides any `service` defined in the `init_config` section.
+## tags - optional - Add tags to the collected logs.
+##
+## Discover Datadog log collection: https://docs.datadoghq.com/logs/log_collection/
+#
+# logs:
+#   - type: file
+#     path: <ACTIVEMQ_BASEDIR>/data/activemq.log
+#     source: activemq
+#     service: <SERVICE_NAME>
+#   - type: file
+#     path: <ACTIVEMQ_BASEDIR>/data/audit.log
+#     source: activemq
+#     service: <SERVICE_NAME>

activemq_xml/manifest.json

@@ -1,6 +1,7 @@
 {
   "categories": [
     "processing",
+    "log collection",
     "messaging",
     "autodiscovery"
   ],