From 030d70e20d0b51023782b38601b0a2f13888aea6 Mon Sep 17 00:00:00 2001 From: Hiroko Takamiya Date: Fri, 20 Sep 2024 12:02:38 -0400 Subject: [PATCH 1/5] Japanese blog 24.0.0.7 --- posts/2024-07-16-24.0.0.7.adoc | 3 + posts/ja/2024-07-16-24.0.0.7.adoc | 195 ++++++++++++++++++++++++++++++ 2 files changed, 198 insertions(+) create mode 100644 posts/ja/2024-07-16-24.0.0.7.adoc diff --git a/posts/2024-07-16-24.0.0.7.adoc b/posts/2024-07-16-24.0.0.7.adoc index bb04e2f54..23037603f 100644 --- a/posts/2024-07-16-24.0.0.7.adoc +++ b/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: /blog/ja/2024/07/16/2024-07-16-24.0.0.7.html --- = Enhancements for MicroProfile Metrics and a new training course in 24.0.0.7 David Mueller diff --git a/posts/ja/2024-07-16-24.0.0.7.adoc b/posts/ja/2024-07-16-24.0.0.7.adoc new file mode 100644 index 000000000..d9eb13e86 --- /dev/null +++ b/posts/ja/2024-07-16-24.0.0.7.adoc @@ -0,0 +1,195 @@ +--- +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/2024-07-16-24.0.0.7.html +--- += Enhancements for MicroProfile Metrics and a new training course in 24.0.0.7 +David Mueller + +: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: + +* <> + +* <> + + + +View the list of fixed bugs in link:https://github.com/OpenLiberty/open-liberty/issues?q=label%3Arelease%3A24007+label%3A%22release+bug%22[24.0.0.7]. + +Check out link:{url-prefix}/blog/?search=release&search!=beta[previous Open Liberty GA release blog posts]. + + +[#run] + + +== 24.0.0.7 を使用してアプリを開発および実行する + +link:{url-prefix}/guides/maven-intro.html[Maven]を使用している場合は、`pom.xml` ファイルに以下を含めます。 + +[source,xml] +---- + + io.openliberty.tools + liberty-maven-plugin + 3.10.3 + +---- + +または、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 // // // // +// 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` エンドポイントに出力されます。 + +新しいプロパティでは、ヒストグラムとタイマー メトリックのパーセンタイルのカスタム セットとヒストグラム バケットのカスタム セットを定義できます。その他の新しい構成プロパティでは、バケット セットの上限と下限を定義するプロパティを含む、ヒストグラム バケットのデフォルト セットを有効にすることができます。 + +これらのプロパティを使用すると、次の構文を使用するセミコロンで区切られた値定義のリストを定義できます。 + +---- +=[,...] +---- + +一部のプロパティは、特定のメトリック名に対して複数の値を受け入れることができますが、他のプロパティは単一の値のみを受け入れることができます。 + +メトリック名の末尾にアスタリスク (`*`) をワイルドカードとして使用できます。 + +[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. + +== Open Liberty 24.0.0.7 を今すぐ入手 + +Open Liberty 24.0.0.7は、<>のリンクから試していただけます。 + From c16b3882ac2e96854ad47d2841cd3b7fd1f95943 Mon Sep 17 00:00:00 2001 From: Eric Covener Date: Tue, 1 Oct 2024 10:53:50 -0400 Subject: [PATCH 2/5] simplify and differentiate examples The preferred algorithm value was the syntax, not a valid value. It's also relatively obscure function. Simplify the examples and make the content-type one dedicated in a third example. --- .../2020-04-22-http-response-compression.adoc | 22 +++++++++++++------ 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/posts/2020-04-22-http-response-compression.adoc b/posts/2020-04-22-http-response-compression.adoc index 37231ddb7..0f23754e0 100644 --- a/posts/2020-04-22-http-response-compression.adoc +++ b/posts/2020-04-22-http-response-compression.adoc @@ -87,10 +87,7 @@ Configuring compression for individual HTTP endpoints: - - +application/* - -text/plain - + ---- @@ -110,11 +107,22 @@ Configuring compression for all HTTP endpoints: compressionRef="myCompressionID"> - + +---- + +The `types` attribute in the following example adds all application content types and removes the `text/plain` content type from the `text/*` default. + +[source,xml] +---- + + +application/* -text/plain - + + ---- -The `types` attribute in the examples adds all application content types and removes the `text/plain` content type from the `text/*` default. + With this new `` configuration option, you can configure Open Liberty to compress HTTP responses before returning them to clients. This reduces bandwidth and the time taken for HTTP clients to get responses. From 2595998028c18f793cf3d7da6b1aadd80433e7ec Mon Sep 17 00:00:00 2001 From: Hiroko Takamiya Date: Thu, 10 Oct 2024 10:29:40 -0400 Subject: [PATCH 3/5] Incorporated Takakiyo-san's review --- posts/ja/2024-07-16-24.0.0.7.adoc | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/posts/ja/2024-07-16-24.0.0.7.adoc b/posts/ja/2024-07-16-24.0.0.7.adoc index d9eb13e86..62748876f 100644 --- a/posts/ja/2024-07-16-24.0.0.7.adoc +++ b/posts/ja/2024-07-16-24.0.0.7.adoc @@ -37,10 +37,9 @@ In link:{url-about}[Open Liberty] 24.0.0.7: * <> +24.0.0.7 で修正されたバグの一覧は link:https://github.com/OpenLiberty/open-liberty/issues?q=label%3Arelease%3A24007+label%3A%22release+bug%22[こちら] です。 -View the list of fixed bugs in link:https://github.com/OpenLiberty/open-liberty/issues?q=label%3Arelease%3A24007+label%3A%22release+bug%22[24.0.0.7]. - -Check out link:{url-prefix}/blog/?search=release&search!=beta[previous Open Liberty GA release blog posts]. +link:{url-prefix}/blog/?search=release&search!=beta[以前の Open Liberty GA (General Availability) リリース ブログ投稿] もチェックして下さい。 [#run] From 7ff9f3e5b1385a1cebcd849544549b8287806f98 Mon Sep 17 00:00:00 2001 From: Hiroko Takamiya Date: Thu, 10 Oct 2024 10:33:31 -0400 Subject: [PATCH 4/5] Update 2024-07-16-24.0.0.7.adoc Fix the link --- posts/2024-07-16-24.0.0.7.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/posts/2024-07-16-24.0.0.7.adoc b/posts/2024-07-16-24.0.0.7.adoc index 23037603f..9a5a76025 100644 --- a/posts/2024-07-16-24.0.0.7.adoc +++ b/posts/2024-07-16-24.0.0.7.adoc @@ -12,7 +12,7 @@ open-graph-image: https://openliberty.io/img/twitter_card.jpg open-graph-image-alt: Open Liberty Logo blog-available-in-languages: - lang: ja - path: /blog/ja/2024/07/16/2024-07-16-24.0.0.7.html + 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 From c4a696df0af57c6a56db49573e8ba2b3f567b487 Mon Sep 17 00:00:00 2001 From: Hiroko Takamiya Date: Thu, 10 Oct 2024 10:34:20 -0400 Subject: [PATCH 5/5] Update 2024-07-16-24.0.0.7.adoc --- posts/ja/2024-07-16-24.0.0.7.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/posts/ja/2024-07-16-24.0.0.7.adoc b/posts/ja/2024-07-16-24.0.0.7.adoc index 62748876f..1ad7c53c0 100644 --- a/posts/ja/2024-07-16-24.0.0.7.adoc +++ b/posts/ja/2024-07-16-24.0.0.7.adoc @@ -16,7 +16,7 @@ additional_authors: image: https://avatars0.githubusercontent.com/una-tapa blog-available-in-languages: - lang: en - path: /blog/2024/07/16/2024-07-16-24.0.0.7.html + 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