Merge pull request #4097 from OpenLiberty/Japanese-blog-24.0.0.7

Japanese blog 24.0.0.7

posts/2024-07-16-24.0.0.7.adoc

@@ -10,6 +10,9 @@ seo-description: The 24.0.0.7 release includes enhancements for histogram and ti
 blog_description: The 24.0.0.7 release includes enhancements for histogram and timer metrics in MicroProfile 3.0 and 4.0. Also, a new beginner-level training course is now available to teach you the essentials of cloud native Java application development with Open Liberty.
 open-graph-image: https://openliberty.io/img/twitter_card.jpg
 open-graph-image-alt: Open Liberty Logo
+blog-available-in-languages:
+- lang: ja
+  path: /ja/blog/2024/07/16/24.0.0.7.html
 ---
 = Enhancements for MicroProfile Metrics and a new training course in 24.0.0.7
 David Mueller <https://github.com/dmuelle>

posts/ja/2024-07-16-24.0.0.7.adoc

@@ -0,0 +1,194 @@
+---
+layout: post
+title: 「24.0.0.7 での MicroProfile Metrics の機能強化と新しいトレーニング コース」
+# Do NOT change the categories section
+categories: blog
+author_picture: https://avatars3.githubusercontent.com/dmuelle
+author_github: https://github.com/dmuelle
+seo-title: 24.0.0.7 での MicroProfile Metrics の機能強化と新しいトレーニング コース - OpenLiberty.io
+seo-description: 24.0.0.7 リリースには、MicroProfile 3.0 および 4.0 のヒストグラムとタイマー メトリックの機能強化が含まれています。また、Open Liberty を使用したクラウド ネイティブ Java アプリケーション開発の基本を学習できる新しい初心者レベルのトレーニング コースも利用可能になりました。
+blog_description: 24.0.0.7 リリースには、MicroProfile 3.0 および 4.0 のヒストグラムとタイマー メトリックの機能強化が含まれています。また、Open Liberty を使用したクラウド ネイティブ Java アプリケーション開発の基本を学習できる、新しい初心者レベルのトレーニング コースも利用可能になりました。
+open-graph-image: https://openliberty.io/img/twitter_card.jpg
+open-graph-image-alt: Open Liberty Logo
+additional_authors: 
+- name: 高宮　裕子 (翻訳)
+  github: https://github.com/una-tapa
+  image: https://avatars0.githubusercontent.com/una-tapa
+blog-available-in-languages:
+- lang: en
+  path: /blog/2024/07/16/24.0.0.7.html
+---
+= Enhancements for MicroProfile Metrics and a new training course in 24.0.0.7
+David Mueller <https://github.com/dmuelle>
+
+:imagesdir: /
+:url-prefix:
+:url-about: /
+
+
+
+24.0.0.7 リリースには、MicroProfile 3.0 および 4.0 のヒストグラムとタイマー メトリックの機能強化が含まれています。また、Open Liberty を使用したクラウド ネイティブ Java アプリケーション開発の基本を学習できる、新しい初心者レベルのトレーニング コースも利用可能になりました。
+
+
+In link:{url-about}[Open Liberty] 24.0.0.7:
+
+* <<mpm, MicroProfile 3.0 および 4.0 でのヒストグラムとタイマー メトリックの強化 >>
+
+* <<course, 新しい「クラウドネイティブ Java アプリケーション開発の基礎」コースで、Open Liberty を使用したアプリケーション開発を学ぶことができます >>
+
+
+24.0.0.7 で修正されたバグの一覧は link:https://github.com/OpenLiberty/open-liberty/issues?q=label%3Arelease%3A24007+label%3A%22release+bug%22[こちら] です。
+
+link:{url-prefix}/blog/?search=release&search!=beta[以前の Open Liberty GA (General Availability) リリース ブログ投稿] もチェックして下さい。
+
+
+[#run]
+
+
+== 24.0.0.7 を使用してアプリを開発および実行する
+
+link:{url-prefix}/guides/maven-intro.html[Maven]を使用している場合は、`pom.xml` ファイルに以下を含めます。
+
+[source,xml]
+----
+<plugin>
+    <groupId>io.openliberty.tools</groupId>
+    <artifactId>liberty-maven-plugin</artifactId>
+    <version>3.10.3</version>
+</plugin>
+----
+
+または、link:{url-prefix}/guides/gradle-intro.html[Gradle] の場合は、`build.gradle` ファイルに次の内容を含めます。
+
+[source,gradle]
+----
+buildscript {
+    repositories {
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'io.openliberty.tools:liberty-gradle-plugin:3.8.3'
+    }
+}
+apply plugin: 'liberty'
+----
+
+または、link:{url-prefix}/docs/latest/container-images.html[コンテナ イメージ] を使用している場合:
+
+[source]
+----
+FROM icr.io/appcafe/open-liberty
+----
+
+または、link:{url-prefix}/start/[ダウンロード・ページ]をご覧ください。
+
+link:https://plugins.jetbrains.com/plugin/14856-liberty-tools[IntelliJ IDEA]、link:https://marketplace.visualstudio.com/items?itemName=Open-Liberty.liberty-dev-vscode-ext[Visual Studio Code]、または link:https://marketplace.eclipse.org/content/liberty-tools[Eclipse IDE]を使用している場合は、オープンソースの link:https://openliberty.io/docs/latest/develop-liberty-tools.html[Liberty 開発者ツール] を活用して、IDE 内から効果的な開発、テスト、デバッグ、アプリケーション管理を行うこともできます。
+
+[link=https://stackoverflow.com/tags/open-liberty]
+image::img/blog/blog_btn_stack_ja.svg[Ask a question on Stack Overflow, align="center"]
+
+// // // // DO NOT MODIFY THIS COMMENT BLOCK <GHA-BLOG-TOPIC> // // // //
+// Blog issue: https://github.com/OpenLiberty/open-liberty/issues/28982
+// Contact/Reviewer: tonyreigns
+// // // // // // // //
+[#mpm]
+== MicroProfile 3.0 および 4.0 でのヒストグラムとタイマー メトリックの強化
+
+このリリースでは、ヒストグラムとタイマー メトリックによって追跡および出力される統計を構成するために使用される MicroProfile 3.0 および 4.0 の MicroProfile Config プロパティが導入されています。これらの変更は、MicroProfile Metrics 5.1 ですでに利用可能です。
+
+以前の MicroProfile Metrics 3.0 および 4.0 リリースでは、ヒストグラムとタイマー メトリックは次の値のみを追跡していました。
+
+* 記録された最小/最大値
+* すべての値の合計
+* 記録された値の数
+* 50 パーセンタイル、75 パーセンタイル、95 パーセンタイル、98 パーセンタイル、99 パーセンタイル、99.9 パーセンタイルの静的なセット
+
+これらの値は、Prometheus 形式で `/metrics` エンドポイントに出力されます。
+
+新しいプロパティでは、ヒストグラムとタイマー メトリックのパーセンタイルのカスタム セットとヒストグラム バケットのカスタム セットを定義できます。その他の新しい構成プロパティでは、バケット セットの上限と下限を定義するプロパティを含む、ヒストグラム バケットのデフォルト セットを有効にすることができます。
+
+これらのプロパティを使用すると、次の構文を使用するセミコロンで区切られた値定義のリストを定義できます。
+
+----
+<metric name>=<value-1>[,<value-2>...<value-n>]
+----
+
+一部のプロパティは、特定のメトリック名に対して複数の値を受け入れることができますが、他のプロパティは単一の値のみを受け入れることができます。
+
+メトリック名の末尾にアスタリスク (`*`) をワイルドカードとして使用できます。
+
+[cols="2*"]
+|===
+| プロパティ | 説明
+| mp.metrics.distribution.percentiles | 追跡および出力するために、ヒストグラムとタイマーのメトリックを一致させるためのパーセンタイルのカスタム セットを定義します。メトリック名の組み合わせに対して整数値と小数値のセットを受け入れます。メトリック名の組み合わせに値が指定されていない場合は、パーセンタイル出力を無効にするために使用できます。
+| mp.metrics.distribution.histogram.buckets| 追跡および出力するヒストグラム メトリックを一致させるための (累積) ヒストグラム バケットのカスタム セットを定義します。メトリック名のペアリングには整数値と小数値のセットを受け入れます。
+| mp.metrics.distribution.timer.buckets| 追跡および出力の対象となるタイマー メトリックを一致させるための (累積) ヒストグラム バケットのカスタム セットを定義します。メトリック名のペアリングには、時間単位 (たとえば、`ms`、`s`、`m`、または `h`) が追加された 10 進数値のセットを受け入れます。
+|mp.metrics.distribution.percentiles-histogram.enabled | 一致するヒストグラムまたはタイマー メトリックを構成して、監視ツールによるパーセンタイル構成を可能にするための大規模なデフォルト ヒストグラム バケット セットを提供します。メトリック名のペアリングには true/false 値を受け入れます。
+| mp.metrics.distribution.histogram.max-value| タイマーに対してパーセンタイル ヒストグラムが有効になっている場合、このプロパティは報告されるバケットの上限を定義します。メトリック名のペアリングには、単一の整数または小数値を受け入れます。
+| mp.metrics.distribution.histogram.min-value| タイマーに対してパーセンタイル ヒストグラムが有効になっている場合、このプロパティは報告されるバケットの下限を定義します。メトリック名のペアリングには、単一の整数または小数値を受け入れます。
+|mp.metrics.distribution.timer.max-value | ヒストグラムに対してパーセンタイル ヒストグラムが有効になっている場合、このプロパティは報告されるバケットの上限を定義します。メトリック名のペアには、時間単位 (たとえば、`ms`、`s`、`m`、または `h`) が追加された単一の 10 進数値を受け入れます。
+|mp.metrics.distribution.timer.min-value | ヒストグラムに対してパーセンタイル ヒストグラムが有効になっている場合、このプロパティは報告されるバケットの下限を定義します。メトリック名のペアには、時間単位 (たとえば、`ms`、`s`、`m`、または `h`) が追加された単一の 10 進数値を受け入れます。
+
+|===
+
+次の例のように、`mp.metrics.distribution.percentiles` プロパティを定義できます。
+
+----
+mp.metrics.distribution.percentiles=alpha.timer=0.5,0.7,0.75,0.8;alpha.histogram=0.8,0.85,0.9,0.99;delta.*=
+----
+
+このプロパティは、50 パーセンタイル値、70 パーセンタイル値、75 パーセンタイル値、80 パーセンタイル値を追跡して出力するための `alpha.timer` タイマー メトリックを作成します。`alpha.histogram` ヒストグラム メトリックは、80 パーセンタイル値、85 パーセンタイル値、90 パーセンタイル値、99 パーセンタイル値を出力します。`delta.*` と一致するヒストグラムまたはタイマー メトリックのパーセンタイルは無効になります。
+
+この例を拡張し、`mp.metrics.distribution.timer.buckets` プロパティを使用して `alpha.timer` タイマー メトリックのヒストグラム バケットを定義します。
+
+----
+mp.metrics.distribution.timer.buckets=alpha.timer=100ms,200ms,1s
+----
+
+この設定は、メトリック ランタイムに、0 ～ 100 ミリ秒、0 ～ 200 ミリ秒、0 ～ 1 秒の範囲内の継続時間を追跡してカウントを出力するように指示します。この出力は、ヒストグラム バケットが _累積_ 方式で動作しているためです。
+
+`/metrics` REST エンドポイントの `alpha.timer` メトリックに対応する Prometheus 出力は、次の例のようになります。
+
+----
+# TYPE application_alpha_timer_mean_seconds gauge
+application_alpha_timer_mean_seconds 2.9700022497975187
+# TYPE application_alpha_timer_max_seconds gauge
+application_alpha_timer_max_seconds 5.0
+# TYPE application_alpha_timer_min_seconds gauge
+application_alpha_timer_min_seconds 1.0
+# TYPE application_alpha_timer_stddev_seconds gauge
+application_alpha_timer_stddev_seconds 1.9997750210918204
+# TYPE alpha_timer_seconds histogram <1>
+application_alpha_timer_seconds_bucket{le="0.1"} 0.0 <2>
+application_alpha_timer_seconds_bucket{le="0.2"} 0.0 <2>
+application_alpha_timer_seconds_bucket{le="1.0"} 1.0 <2>
+application_alpha_timer_seconds_bucket{le="+Inf"} 2.0 <2> <3>
+application_alpha_timer_seconds_count 2
+application_alpha_timer_seconds_sum 6.0
+application_alpha_timer_seconds{quantile="0.5"} 1.0
+application_alpha_timer_seconds{quantile="0.7"} 5.0
+application_alpha_timer_seconds{quantile="0.75"} 5.0
+application_alpha_timer_seconds{quantile="0.8"} 5.0
+----
+
+<1> Prometheus メトリック タイプは `histogram` です。このタイプでは、分位数/パーセンタイルとバケットの両方が表されます。
+
+<2> `le` タグは _未満_ を表し、秒に変換される定義されたバケット用です。
+
+<3> Prometheus では、`+Inf` バケットがすべてのヒットをカウントする必要があります。
+
+
+
+[#course]
+== 新しい「クラウドネイティブ Java アプリケーション開発の基礎」コースで、Open Liberty を使用したアプリケーション開発を学ぶことができます
+
+link:https://cognitiveclass.ai/courses/essentials-for-java-application-development-with-liberty[クラウドネイティブJavaアプリケーション開発の基本] コースが link:http://cognitiveclass.ai/[cognitiveclass.ai] サイトで公開されています。
+
+このコースでは、Open Libertyを使用して基本的なクラウドネイティブJavaアプリケーションを作成するための基本的なスキルと技術を学びます。RESTアプリケーション、コンテキストと依存性の注入（CDI）、アプリケーション構成の外部化などについて学ぶことができます。最終クイズ（20の選択問題）で80％以上のスコアを獲得すると、link:https://www.credly.com/org/ibm/badge/liberty-developer-essentials[Liberty Developer Essentials] バッジをCredlyから受け取ることができます。
+
+// DO NOT MODIFY THIS LINE. </GHA-BLOG-TOPIC>
+
+== Open Liberty 24.0.0.7 を今すぐ入手
+
+Open Liberty 24.0.0.7は、<<run,Maven, Gradle, Docker, and as a downloadable archive>>のリンクから試していただけます。
+