チュートリアル:ログソリューションとして Elastic on Azure を使用して WebLogic Server を Azure に移行する

[アーティクル]
01/05/2025

このチュートリアルでは、Azure Virtual Machines (VM) に WebLogic Server (WLS) をデプロイし、Elastic Cloud (Elasticsearch) と統合します。また、WLS からログデータをキャプチャするように Elastic Custom Logs を構成します。最後に、Kibana を使用して WLS ログを検索および分析します。各コンポーネントは個別に文書化されていますが、このチュートリアルでは、Azure 上の WLS に堅牢なログ管理ソリューションを提供するためにシームレスに統合する方法を示します。

WLS、App Gateway、ELK の関係を示す図。

このチュートリアルでは、次の方法について説明します。

Elastic on Azure インスタンスを作成します。
Azure に WLS をデプロイします。
WLS ログを統合するように Elastic Custom Logs を構成します。
Kibana から WebLogic Server ログを検索します。

前提条件

アクティブな Azure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、無料アカウント作成。
「Azure Virtual Machines 上で Oracle WebLogic Server を実行するためのソリューションとは」に記載されているいずれかの WLS を Virtual Machines Azure アプリケーションにデプロイする機能。
仮想マシンへの SSH アクセス用のターミナル。

Azure に WLS をデプロイする

Azure Virtual Machines で Oracle WebLogic Server を実行するためのソリューションの手順に従って WebLogic Server をプロビジョニングする"単一ノードに管理サーバーを使用して Oracle WebLogic Server をデプロイする" と "Deploy Oracle WebLogic Server Cluster on Microsoft Azure IaaS" の両方が Elastic on Azure と互換性があります。このチュートリアルでは、例として VM WebLogic を使用します。

手記

既定の VM サイズには、エラスティックエージェント用の十分なメモリがない可能性があります。選択した VM サイズに少なくとも 2.5 GB のメモリがあることを確認します。 Standard_A2_v2 は最小十分なサイズです

必要な情報を入力したら、[ の作成] を選択して、Azure での WLS デプロイを開始します。通常、デプロイには約 30 分かかります。デプロイ後、出力に移動し、管理コンソールにアクセスするための URL adminConsoleURLの値を記録します。

WebLogic ログについて

WebLogic Server サブシステムは、ログサービスを使用して、アプリケーションのデプロイやサブシステムの障害などのイベントを追跡します。これらのログを使用すると、サーバーインスタンスは状態を伝え、特定のイベントに応答し、トラブルシューティングと監視に役立つ詳細な分析情報を提供できます。 WebLogic のログサービスを使用すると、エラーの報告、特定のサブシステムからのログメッセージのリッスン、システム状態の更新のキャプチャを行うことができます。 WebLogic ログサービスの詳細については、「WebLogic Logging Servicesについて」を参照してください。

このチュートリアルでは、次の主要な WebLogic ログを構成することに重点を置いています。

サーバーログファイル: 通常、サーバーインスタンスのルートの下にあるディレクトリログにあります。パスは通常、DOMAIN_NAME/servers/SERVER_NAME/logs/SERVER_NAME.logです。
ドメインログファイル: これらのログは、ドメインの状態の概要を示し、管理サーバーのログディレクトリに格納されます。既定のパスは DOMAIN_NAME/servers/ADMIN_SERVER_NAME/logs/DOMAIN_NAME.logです。
HTTP アクセスログ: 既定では、HTTP アクセスログはサーバーログのディレクトリとローテーションポリシーを共有します。既定のパスは DOMAIN_NAME/servers/SERVER_NAME/logs/1access.logです。

これらのログを構成および管理して、Elastic on Azure などの監視ツールとの統合を容易にし、一元的なログ分析と WebLogic Server インスタンスでのアラートを有効にすることができます。

オファーがデプロイされている間は、「Azure インスタンスで Elasticsearch を作成する」セクションの手順に進んで従うことができます。オファーのデプロイが完了したら、ここに戻ってきてください。

WLS マシンに接続する

WebLogic Server (WLS) を実行している仮想マシンにアクセスするには、「仮想マシンに接続する」の手順を使用します。このチュートリアルでは、adminVMという名前の WebLogic 管理サーバーをホストするコンピューターに接続します。

Azure インスタンスで Elasticsearch を作成する

Elastic Cloud (Elasticsearch) for Azure は、Azure Marketplace から取得して Azure portal でデプロイできる Azure Native ISV サービスです。 Azure Native ISV Services を使用すると、独立系ソフトウェアベンダー (ISV) のソフトウェアとサービスを Azure に簡単にプロビジョニング、管理、および緊密に統合できます。 Elastic Cloud - Azure Native ISV Service は、Microsoft と Elastic によって開発および管理されています。 Elastic リソースの作成、プロビジョニング、管理は、Azure portal を使用して行います。 Elastic は、作成された Elastic アカウントを含む SaaS アプリケーションを所有し、実行します。 Elastic Cloud (Elasticsearch) の概要については、「Elastic Cloud とは (Elasticsearch) - Azure Native ISV サービス」を参照してください。

Azure で Elastic を作成する

Elastic アプリケーションを作成するには、「クイックスタート: Elasticの概要」の手順に従います。

「リソースの作成」セクションの最初の手順では、置換に次の手順を使用します。

[基本] ウィンドウの [プランの詳細] で次の手順を使用します。
1. [リソースグループ] で一意のリソースグループ名を入力します。このチュートリアルでは、elkrg1030を使用します。
2. リソース名には、Elastic インスタンスの一意の名前を入力します。リソースグループのに使用したのと同じ値使用できます。
3. [リージョン]で、目的のリージョンを選択します。
4. 他のフィールドの既定値をそのまま使用します。
[ログ & メトリック] ウィンドウで、Azure リソースを監視するために [サブスクリプションのアクティビティログを送信する] と [すべての定義済みリソースについて Azure リソースログを送信する] を選択します。ただし、このチュートリアルでは WLS ログのみに焦点を当てており、インフラストラクチャログについては説明しません。
[Azure OpenAI 構成] セクションと [タグ] セクションはスキップしても構いません。
記事の残りの手順に従います。

デプロイが成功したら、この記事の次のセクションに進みます。

Kibana を起動する

Elastic が Azure にデプロイされたら、Azure portal から Elastic リソースを開きます。次のスクリーンショットに示すように、デプロイ URLラベルの横にある Kibana URL を見つけます。

Kibana を起動すると、Azure アカウントを選択してサインインするように求められます。 Elastic デプロイの作成に使用する Azure アカウントを選択し、要求された Elasticsearch アクセス許可を確認して受け入れます。

サインインすると、次のスクリーンショットに示すように、ブラウザーは Kibana のウェルカムページに移動します。

エラスティックカスタムログを構成し、WLS ログを統合する

Kibana 上の WebLogic Server のカスタムログ統合を設定するには、次の手順に従います。

Kibana の統合セットアップに移動するには、次の手順に従います。
1. Kibana のウェルカムページで、[統合を追加して開始する] を見つけて [統合を追加] を選択します。
2. カスタムログ を検索し、それを選択します。
3. カスタムログの追加 を選択して、Elastic Agent をインストールして統合を追加する手順を表示します。
Elastic Agent をインストールするには、次の手順に従います。
1. [Elastic Agentのインストール] を選択すると、インストールの手順が表示されます。
2. 次のコマンドを使用して、WLS マシンに SSH 接続し、ルート特権に切り替えます。
```
sudo su -
```
3. Kibana から、ホストに Elastic Agent をインストールするセクションから Linux Tar コマンドをコピーし、WLS マシンで実行します。
4. コンピューターのターミナルで、次の例に示すように、y を入力してインストールを確認します。
```
Elastic Agent will be installed at /opt/Elastic/Agent and will run as a service. Do you want to continue? [Y/n]:y
```
  Elastic Agent has been successfully installed. テキストを探します。このテキストは、正常にインストールされたことを示します。このテキストが表示されない場合は、トラブルシューティングを行い、問題を解決してから続行してください。
エージェントの登録を確認します。 Kibana で、[エージェント登録の確認] の下で [エージェント登録] を確認します。
WLS ドメインログの統合を追加するには、次の手順に従います。
1. を選択して統合を追加します。
2. [カスタムログファイルで、次のプロパティを設定します。
  - ログファイルパスの場合は、/u01/domains/adminDomain/servers/admin/logs/adminDomain.logを使用します。
  - データセット名には、汎用使用します。
3. [詳細オプション] を展開します。カスタム構成場合は、次のプロパティを設定します。
  - multiline.typeの場合は、パターンを使います。
  - multiline.pattern で '^####' を使用します。
  - multiline.negateの場合は、trueを使用します。
  - multiline.match で after を使用します。
4. 詳細設定オプションを展開します。 [統合名]には「log-weblogic-domain-log」と入力します。
5. 受信データの確認 を選択して、ログをプレビューします。次に、[アセットの表示] ->[アセット] ->[ビュー] ->[ログ] を選択し、Kibana でドメインログを表示します。
6. テキスト [ログメッセージの検索] を含むテキストエリアで、文字列「weblogic」を入力して Enter キーを押します。 weblogic文字列を含むログメッセージが表示されます。
次の手順を使用して、サーバーログと HTTP アクセスログの統合を追加します。
1. Kibana で、「統合」を検索してそれを選択します。
2. カスタムログ >インストール済み統合を選択>カスタムログを追加します。
3. ログの種類 (サーバー、HTTP アクセスログ) ごとに、次の一覧から適切な構成を入力します。すべての構成フィールドに入力した後、[保存して続行] を選択し、次に [変更を保存して展開]を選択します。
  - サーバーログの場合は、次の値を使用します。
    - [統合設定] > [統合名] で log-weblogic-server-log を使用します。
    - カスタムログファイル > ログファイルパスには、/u01/domains/adminDomain/servers/admin/logs/admin.logを使用します。
    - [カスタムログファイル] > [詳細オプション] > [カスタム構成] で次の値を使用します。
      - multiline.typeの場合は、パターンを使用します。
      - multiline.pattern で '^####' を使用します。
      - multiline.negateの場合は、trueを使用します。
      - multiline.matchの場合は、の後にを使用します。
    - [この統合を追加する場所] > [既存のホスト] で [最初のエージェントポリシー] を使用します。
  - HTTP アクセスログの場合は、次の値を使用します。
    - [統合設定] > [統合名] で log-http-access-log を使用します。
    - [カスタムログファイル] > [ログファイルパス] で /u01/domains/adminDomain/servers/admin/logs/access.log を使用します。
    - カスタムログファイル > カスタム構成> 詳細オプションの場合、構成は指定されません。
    - [この統合を追加する場所] > [既存のホスト] で [最初のエージェントポリシー] を使用します。

Kibana で WLS ログを検索する

統合後、次の手順を使用して、Kibana 内のログの分析を開始します。

発見ページにアクセスするには、ハンバーガーメニューを開きます。次に、Analyticsで Discoverを選択します。
ログインデックスを選択するには、[検出] ページで [logs-*] を選択します。
WLS ログを検索してフィルター処理します。 Discoverの使用方法の詳細については、Kibana ドキュメントの「Discover」を参照してください。

手記

WLS クラスターを実行している場合は、各 VM に Elastic Agent をインストールし、対応するホストにカスタムログを構成する必要があります。

リソースのクリーンアップ

WLS または Elastic スタックを使用しなくなった場合は、このセクションの手順に従ってクリーンアップできます。

WLS をクリーンアップする

WLS をクリーンアップするには、次の手順に従います。

Azure portal のホームページで、[リソースグループ]選択します。
任意のフィールドの フィルター... テキストフィールドに、WLS デプロイを作成したリソースグループの名前を入力します。
一覧にリソースグループが表示されたら、それを選択します。
リソースグループ 概要から、[リソースグループの削除]を選択します。
[削除しますか?] セクションで、リソースグループの名前を入力して [削除] を選択します。リソースグループとその内容が削除されている間も、引き続き Azure portal を操作できます。

Azure で Elastic をクリーンアップする

前のセクションと同じ手順に従って Elastic on Azure を削除しますが、削除するリソースグループとして Elastic on Azure デプロイのリソースグループ名を使用します。

次の手順

WebLogic Server から Azure Virtual Machines への移行を続行します。

WebLogic Server から Azure Virtual Machine へ

次の方法で共有

チュートリアル:ログソリューションとして Elastic on Azure を使用して WebLogic Server を Azure に移行する

前提条件