Issue 7212 - Allow multiple YAML configuration files for JMX rules

instrumentation/jmx-metrics/javaagent/README.md

@@ -30,20 +30,20 @@ No targets are enabled by default. The supported target environments are listed
 - [wildfly](wildfly.md)
 - [hadoop](hadoop.md)
 
-## Configuration File
+## Configuration Files
 
-To provide your own metric definitions, create a YAML configuration file, and specify its location using the `otel.jmx.config` property. For example
+To provide your own metric definitions, create one or more YAML configuration files, and specify their location using the `otel.jmx.config` property. Absolute or relative pathnames can be specified. For example
 
 ```bash
 $ java -javaagent:path/to/opentelemetry-javaagent.jar \
-     -Dotel.jmx.config=path/to/config_file.yaml \
+     -Dotel.jmx.config=path/to/config_file.yaml,more_rules.yaml \
      ... \
      -jar myapp.jar
 ```
 
 ### Basic Syntax
 
-The configuration file can contain multiple entries (which we call _rules_), defining a number of metrics. Each rule must identify a set of MBeans and the name of the MBean attribute to query, along with additional information on how to report the values. Let's look at a simple example.
+Each configuration file can contain multiple entries (which we call _rules_), defining a number of metrics. Each rule must identify a set of MBeans and the name of the MBean attribute to query, along with additional information on how to report the values. Let's look at a simple example.
 
 ```yaml
 ---

instrumentation/jmx-metrics/javaagent/src/main/java/io/opentelemetry/instrumentation/javaagent/jmx/JmxMetricInsightInstaller.java

@@ -59,7 +59,7 @@ private static void addRulesForPlatform(String platform, MetricConfiguration con
       if (inputStream != null) {
         JmxMetricInsight.getLogger().log(FINE, "Opened input stream {0}", yamlResource);
         RuleParser parserInstance = RuleParser.get();
-        parserInstance.addMetricDefsTo(conf, inputStream);
+        parserInstance.addMetricDefsTo(conf, inputStream, platform);
       } else {
         JmxMetricInsight.getLogger().log(INFO, "No support found for {0}", platform);
       }
@@ -80,14 +80,15 @@ private static void buildFromDefaultRules(
 
   private static void buildFromUserRules(
       MetricConfiguration conf, ConfigProperties configProperties) {
-    String jmxDir = configProperties.getString("otel.jmx.config");
-    if (jmxDir != null) {
-      JmxMetricInsight.getLogger().log(FINE, "JMX config file name: {0}", jmxDir);
+    String files = configProperties.getString("otel.jmx.config", "");
+    String[] configFiles = files.isEmpty() ? new String[0] : files.split(",");
+    for (String configFile : configFiles) {
+      JmxMetricInsight.getLogger().log(FINE, "JMX config file name: {0}", configFile);
       RuleParser parserInstance = RuleParser.get();
-      try (InputStream inputStream = Files.newInputStream(new File(jmxDir.trim()).toPath())) {
-        parserInstance.addMetricDefsTo(conf, inputStream);
+      try (InputStream inputStream = Files.newInputStream(new File(configFile).toPath())) {
+        parserInstance.addMetricDefsTo(conf, inputStream, configFile);
       } catch (Exception e) {
-        JmxMetricInsight.getLogger().warning(e.getMessage());
+        JmxMetricInsight.getLogger().warning(e.toString());
       }
     }
   }

instrumentation/jmx-metrics/library/src/main/java/io/opentelemetry/instrumentation/jmx/yaml/RuleParser.java

@@ -51,17 +51,18 @@ public JmxConfig loadConfig(InputStream is) throws Exception {
    *
    * @param conf the metric configuration
    * @param is the InputStream with the YAML rules
+   * @param id identifier of the YAML ruleset, such as a filename
    */
-  public void addMetricDefsTo(MetricConfiguration conf, InputStream is) {
+  public void addMetricDefsTo(MetricConfiguration conf, InputStream is, String id) {
     try {
 
       JmxConfig config = loadConfig(is);
       if (config != null) {
-        logger.log(INFO, "Found {0} metric rules", config.getRules().size());
+        logger.log(INFO, id + ": found {0} metric rules", config.getRules().size());
         config.addMetricDefsTo(conf);
       }
     } catch (Exception exception) {
-      logger.log(WARNING, "Failed to parse YAML rules: " + rootCause(exception));
+      logger.log(WARNING, "Failed to parse YAML rules from " + id + ": " + rootCause(exception));
       // It is essential that the parser exception is made visible to the user.
       // It contains contextual information about any syntax issues found by the parser.
       logger.log(WARNING, exception.toString());