利用千分尺实现新型文物与弹簧靴的集成

2022-04-03 00:00:00 prometheus java spring-boot micrometer newrelic

我正在尝试使用测微计将一个简单的Spring Boot应用程序与New Relic集成。

以下是配置详细信息：-

application.properties

management.endpoints.web.exposure.include=*
management.endpoint.health.show-details=always

management.metrics.export.newrelic.enabled=true
management.metrics.export.newrelic.api-key:MY_API_KEY // Have added the API key here
management.metrics.export.newrelic.account-id: MY_ACCOUNT_ID // Have added the account id here
logging.level.io.micrometer.newrelic=TRACE

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.5.5</version>
        <relativePath /> <!-- lookup parent from repository -->
    </parent>
    <groupId>springboot.micrometer.demo</groupId>
    <artifactId>micrometer-new-relic</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>micrometer-new-relic</name>
    <description>Demo project for actuator integration with new relic using micrometer</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>io.micrometer</groupId>
            <artifactId>micrometer-registry-new-relic</artifactId>
        </dependency>
        <dependency>
            <groupId>io.micrometer</groupId>
            <artifactId>micrometer-registry-prometheus</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-aop</artifactId>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

我能够使用micrometer-registry-prometheus依赖项将Prometheus与此应用程序集成。我将普罗米修斯设置为在本地系统的Docker容器中运行。我使用了以下一组命令-

docker pull prom/prometheus
docker run -p 9090:9090 -v D:/Workspaces/STS/server_sent_events_blog/micrometer-new-relic/prometheus.yml:/etc/prometheus/prometheus.yml prom/prometheus

prometheus.yml

global:
  scrape_interval: 4s
  evaluation_interval: 4s

scrape_configs:
  - job_name: 'spring_micrometer'
    metrics_path: '/actuator/prometheus'
    scrape_interval: 5s
    static_configs:
      - targets: ['my_ip_address:8080']

当我导航到localhost:9090/targets时，我可以看到Prometheus仪表板显示了我的应用程序详细信息，并且可以从中获取数据。在仪表板中，我还可以看到我的自定义指标以及其他指标。

所以我的问题是，我想使用New Relic实现相同的功能。我已经添加了micrometer-registry-new-relicPOM依赖项。我也分享了application.properties文件。我可以在我的控制台中看到日志，说明它正在向New Relic发送数据-

2021-10-24 12:42:04.889 DEBUG 2672 --- [trics-publisher] i.m.n.NewRelicInsightsApiClientProvider : successfully sent 58 metrics to New Relic.

问题：

  1. 下一步是什么？
  2. 我是否需要一个本地运行的New Relic服务器，就像我为普罗米修斯做的那样？
  3. 我可以在哪里可视化此数据？我在New Relic有一个账户，在那里我什么也看不到

https://discuss.newrelic.com/t/integrate-spring-boot-actuator-with-new-relic/126732 根据上面的链接，Spring Bootctuator将指标作为事件类型"SpringBootSample"进行推送。 使用NRQL查询，我们可以确认这一点-

FROM SpringBootSample SELECT max(value) TIMESERIES 1 minute WHERE metricName = 'jvmMemoryCommitted'

  1. 此查询的结果表明什么？它是与我的应用程序相关的指标吗？

这里是我在这里分享的演示的GitHub link。 我没有找到任何关于这方面的明确说明，有一些例子，但使用Java代理。

我们将非常感谢您的任何帮助。

解决方案

根据我目前所学。 有三种方法可以将New Relic与Spring Boot应用程序集成-

  1. 使用New Relic提供的Java代理
  2. 使用New Relic的千分尺依赖
  3. 千分表的新遗迹依赖

1.使用New Relic提供的Java代理进行配置

  1. 从此URL下载Java代理-https://docs.newrelic.com/docs/release-notes/agent-release-notes/java-release-notes/
  2. 提取它。
  3. 修改解压缩文件夹中的newrelic.yml文件以包含您的 许可证密钥(_K)： 应用程序名称：
  4. 创建具有一些REST终结点的SpringBoot应用程序。
  5. 生成应用程序。
  6. 导航到您解压了newRelic Java代理的根路径。
  7. 输入此命令 java -javagent:<path to your new relic jar> ewrelic.jar -jar <path to your application jar><you rapplication jar name>.jar

查看应用程序指标-

  1. 登录到您的新文物帐户。
  2. 转到资源管理器选项卡。
  3. 点击服务-APM
  4. 您可以在那里看到您的应用程序的名称(您在newrelic.yml文件中提到过)。
  5. 单击应用程序名称。
  6. 仪表板应如下所示。

使用New Relic的微米依赖项是执行此操作的首选方法。

2.使用New Relic的微米依赖项进行配置

  1. 添加此依赖项
<dependency>
        <groupId>com.newrelic.telemetry</groupId>
        <artifactId>micrometer-registry-new-relic</artifactId>
        <version>0.7.0</version>
    </dependency>
  1. 修改MicrometerConfig.java类以添加您的API密钥和应用程序名称。
import java.net.InetAddress;
import java.net.UnknownHostException;

import org.springframework.boot.actuate.autoconfigure.metrics.CompositeMeterRegistryAutoConfiguration;
import org.springframework.boot.actuate.autoconfigure.metrics.MetricsAutoConfiguration;
import org.springframework.boot.actuate.autoconfigure.metrics.export.simple.SimpleMetricsExportAutoConfiguration;
import org.springframework.boot.autoconfigure.AutoConfigureAfter;
import org.springframework.boot.autoconfigure.AutoConfigureBefore;
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import com.newrelic.telemetry.Attributes;
import com.newrelic.telemetry.micrometer.NewRelicRegistry;
import com.newrelic.telemetry.micrometer.NewRelicRegistryConfig;

import java.time.Duration;
import io.micrometer.core.instrument.config.MeterFilter;
import io.micrometer.core.instrument.util.NamedThreadFactory;

@Configuration
@AutoConfigureBefore({ CompositeMeterRegistryAutoConfiguration.class, SimpleMetricsExportAutoConfiguration.class })
@AutoConfigureAfter(MetricsAutoConfiguration.class)
@ConditionalOnClass(NewRelicRegistry.class)
public class MicrometerConfig {

    @Bean
    public NewRelicRegistryConfig newRelicConfig() {
        return new NewRelicRegistryConfig() {
            @Override
            public String get(String key) {
                return null;
            }

            @Override
            public String apiKey() {
                return "your_api_key"; // for production purposes take it from config file
            }

            @Override
            public Duration step() {
                return Duration.ofSeconds(5);
            }

            @Override
            public String serviceName() {
                return "your_service_name"; // take it from config file
            }

        };
    }

    @Bean
    public NewRelicRegistry newRelicMeterRegistry(NewRelicRegistryConfig config) throws UnknownHostException {
        NewRelicRegistry newRelicRegistry = NewRelicRegistry.builder(config)
                .commonAttributes(new Attributes().put("host", InetAddress.getLocalHost().getHostName())).build();
        newRelicRegistry.config().meterFilter(MeterFilter.ignoreTags("plz_ignore_me"));
        newRelicRegistry.config().meterFilter(MeterFilter.denyNameStartsWith("jvm.threads"));
        newRelicRegistry.start(new NamedThreadFactory("newrelic.micrometer.registry"));
        return newRelicRegistry;
    }
}
  1. 运行应用程序。

查看应用程序指标-

  1. 登录到您的新文物帐户。
  2. 转到资源管理器选项卡。
  3. 点击服务-开放遥测
  4. 您可以在那里看到您的应用程序的名称(您在MicrometerConfig文件中提到过)。
  5. 单击应用程序名称。
  6. 仪表板应如下所示。

相关文章