Micrometerೖ໳ Javaίϛϡˏ෱Ԭ ษڧձ1910 2019/10/08 @matsumana

Self Introduction • Nameɿ Manabu Matsuzaki • Work atɿ LINE Fukuoka Corporation • Roleɿ SRE • Twitterɿ @matsumana

Agenda • Micrometerೖ໳ • MicrometerͷओཁͳMeterͱTag • MicrometerΛ࢖͏ • Micrometerͷ֤छMeterΛ࢖ͬͯࣗ෼ͰϝτϦΫεΛه࿥͢Δ • Spring BootΞϓϦͰ࢖͏ • Binder • Demo

͜ͷࢿྉ͸ҎԼͷόʔδϣϯΛݩʹ࡞੒͍ͯ͠·͢ • Micrometer: 1.3.0 (LTS) • https://github.com/micrometer-metrics/micrometer/releases • Spring Boot: 2.2.0 RC1 • https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-2.2- Release-Notes • Armeria: 0.94.0 (Micrometerͷ࢖͍ํͷαϯϓϧͱͯ͠঺հ͠·͢) • https://github.com/line/armeria/releases

Micrometerͱ͸ʁ

https://micrometer.io/

Micrometer͕αϙʔτ͍ͯ͠Δ ϞχλϦϯάγεςϜ • Datadog • Prometheus • Elasticsearch • etc…

MicrometerͷओཁͳMeterͱTag

ओཁͳMeter આ໌ Counter ୯७૿Ճ͢ΔϝτϦΫε ྫʣग़ྗͨ͠logͷճ਺ Gauge ஋্͕Լ͢ΔϝτϦΫε ྫʣin-flight(ݱࡏॲཧத)ͷϦΫΤετ਺ Timer ϝιουͷॲཧ࣌ؒܭଌͳͲ LongTaskTimer ͕͔͔࣌ؒΔॲཧͷ࣌ؒܭଌ DistributionSummary Πϕϯτͷαϯϓϧ෼෍ ྫʣhttpͷrequest/responseαΠζ

TagͰϝτϦΫεʹ৘ใΛ෇Ճ͢Δ • Tag͸key-valueͷϖΞ • 1ͭͷϝτϦΫεʹରͯ͠ෳ਺ͷTagΛ෇ՃͰ͖Δ • Tag͕࣮ࡍͷϝτϦΫεͰͲ͏ѻΘΕΔ͔͸ɺ
 ࣗ෼͕࢖͏ϞχλϦϯάγεςϜ࣍ୈ

TagͰϝτϦΫεʹ৘ใΛ෇Ճ͢Δ • Πϝʔδɿ TagΛαϙʔτ͢ΔϞχλϦϯάγεςϜ TagΛαϙʔτ͠ͳ͍ϞχλϦϯάγεςϜ http_server_requests{uri=“/foo”, status=“200"} 10 http_server_requests_foo_200 10 http_server_requests{uri=“/foo”, status=“500"} 2 http_server_requests_foo_500 20 http_server_requests{uri=“/bar”, status=“200"} 21 http_server_requests_bar_200 21 http_server_requests{uri=“/bar”, status=“500"} 4 http_server_requests_bar_500 4

Tag͕࢖͑Δ Tag͕࢖͑ͳ͍ AppOptics, Atlas, Azure Monitor, Cloudwatch, Datadog, Datadog StatsD, Dynatrace, Elastic, Humio, Influx, KairosDB, New Relic, Prometheus, SignalFx, Sysdig StatsD, Telegraf StatsD, Wavefront Graphite, Ganglia, JMX, Etsy StatsD ֤ϞχλϦϯάγεςϜͷTagαϙʔτ https://micrometer.io/docs/concepts#_supported_monitoring_systems

ϝτϦΫεͱTagͷ໋໊نଇ • ϝτϦΫεͱLabelͷ໊લ͸େࣄͰ͢ • MicrometerͷυΩϡϝϯτ • Naming meters:
 https://micrometer.io/docs/concepts#_naming_meters • PrometheusͷυΩϡϝϯτ • Metric and label naming:
 https://prometheus.io/docs/practices/naming/

MicrometerΛ࢖͏

Micrometerͷ֤छMeterΛ࢖ͬͯ ࣗ෼ͰϝτϦΫεΛه࿥͢Δ

αϯϓϧϓϩάϥϜ • Micrometerιʔεrepoʹ͋ΔαϯϓϧϓϩάϥϜ • https://github.com/micrometer-metrics/micrometer/tree/v1.3.0/ samples/micrometer-samples-core/src/main/java/io/micrometer/ core/samples • CounterSample.java • GaugeSample.java • TimerSample.java

αϯϓϧϓϩάϥϜ • Micrometerͷ࢖͍ํ͸Armeria΋ࢀߟʹͳΓ·͢ • ྫʣϦΫΤετ/ϨεϙϯεͷϝτϦΫε • https://github.com/line/armeria/blob/armeria-0.94.0/core/src/main/java/com/linecorp/ armeria/internal/metric/RequestMetricSupport.java#L241-L247 • https://github.com/line/armeria/blob/armeria-0.94.0/core/src/main/java/com/linecorp/ armeria/common/logging/DefaultRequestLog.java • ϦΫΤετ੒ޭ਺ɺϦΫΤετΤϥʔ਺ (Counter) • ϦΫΤετॲཧ࣌ؒ (Timer) • ϦΫΤεταΠζɺϨεϙϯεαΠζ (DistributionSummary)

Spring BootΞϓϦͰ࢖͏

ΞϓϦέʔγϣϯઃఆ (Must) • ActuatorΛґଘϥΠϒϥϦʹ௥Ճ
 org.springframework.boot:spring-boot-starter-actuator • ࣗ෼͕࢖͏ϞχλϦϯάγεςϜ༻ͷґଘϥΠϒϥϦ΋௥Ճ • Prometheusͷ৔߹: io.micrometer:micrometer-registry-prometheus • Datadogͷ৔߹: io.micrometer:micrometer-registry-datadog

ΞϓϦέʔγϣϯઃఆ (Optional) • Prometheusͷ৔߹ɺΞϓϦέʔγϣϯଆʹPrometheusαʔό͕ Scrape͢ΔEndpoint͕ඞཁɻ • application.yml(or application.properties)ʹઃఆΛߦ͏ • management.endpoints.web.exposure.includeʹprometheusΛ௥Ճ
 ྫʣ
 management.endpoints.web.exposure.include=info, health, prometheus

ΞϓϦέʔγϣϯઃఆʢ͓͢͢Ίʣ • ݸਓతʹɺҎԼ΋ઃఆ͢ΔࣄΛ͓͢͢Ί • URIຖͷϨΠςϯγͷϝτϦΫε
 management.metrics.distribution.percentiles.http.server.requests

ؔ࿈υΩϡϝϯτͱࢀߟϒϩά • Spring Boot Actuator: Production-ready Features
 https://docs.spring.io/spring-boot/docs/2.2.0.RC1/reference/html/ production-ready-features.html • Spring BootΞϓϦͷϝτϦΫεΛMicrometerͰऩू͢Δ
 https://matsumana.info/blog/2018/05/23/collect-spring-boot-app- metrics-with-micrometer/ • ϨΠςϯγʔΛܭࢉ͢Δٕज़ͷ࿩
 https://engineering.linecorp.com/ja/blog/latency-calculation-techniques/

Binder

Binderͱ͸ʁ • ϞχλϦϯάର৅(JVM/APαʔό/ϥΠϒϥϦͳͲ)ͱMicrometerͱͷͭͳ͗໾ • ϞχλϦϯάର৅ࣗ਎͕͍࣋ͬͯΔϝτϦΫεΛMicrometerܦ༝ͰϞχλϦ ϯάγεςϜʹૹΔࣄ͕Ͱ͖Δ
 • Micrometerͷඪ४Binder
 https://github.com/micrometer-metrics/micrometer/tree/v1.3.0/micrometer- core/src/main/java/io/micrometer/core/instrument/binder • JVMɺTomcatɺJettyɺLogbackɺCaffeineɺetc…

Binderͱ͸ʁ • ྫ͑͹ɺJVMؔ࿈ͷϝτϦΫε͸ҎԼ • https://github.com/micrometer-metrics/micrometer/tree/v1.3.0/ micrometer-core/src/main/java/io/micrometer/core/instrument/binder/jvm • JvmGcMetrics.java • JvmMemoryMetrics.java • JvmThreadMetrics.java • ClassLoaderMetrics.java

DEMO • αϯϓϧΞϓϦ • https://github.com/matsumana/micrometer-example • DatadogʹϝτϦΫεΛอଘ͢Δ • PrometheusʹϝτϦΫεΛอଘͯ͠GrafanaͰՄࢹԽ͢Δ • JVMϝτϦΫεͷμογϡϘʔυ • HikariCPϝτϦΫεͷμογϡϘʔυ

·ͱΊ • MicrometerͷओཁͳMeterͱTagʹ͍ͭͯઆ໌͠·ͨ͠ • MeterΛ࢖ͬͯϝτϦΫεΛه࿥͢Δํ๏ʹ͍ͭͯઆ໌͠·ͨ͠ • Binderʹ͍ͭͯઆ໌͠·ͨ͠ • DatadogɺPrometheusͷσϞΛ͓ݟͤ͠·ͨ͠ • JVMͱHikariCPͷϝτϦΫεΛGrafanaͰՄࢹԽͯ͠Έ·ͨ͠

Thank you :)