OpenResty Edge でゲートウェイのアクセスログファイルを設定する
このチュートリアルでは、OpenResty Edge でアプリケーションのアクセスログ形式を設定する方法を紹介します。
グローバル設定ページでアクセスログフォーマットを設定する
いつものように、OpenResty Edge の Admin Web コンソールにアクセスしましょう。これは当社のコンソールのサンプルデプロイメントです。各ユーザーには独自のローカルデプロイメントがあります。
まず、アクセスログのフォーマットを設定しましょう。
Global Config ページに移動します。
現在のグローバル設定は「default」という名前のネットワークパーティションに属しています。
ログ設定の部分に直接移動します。
これがデフォルトで使用されるログファイルディレクトリです。このディレクトリを変更する場合は、変更後のディレクトリがすべてのゲートウェイサーバーに存在することを確認する必要があります。
これは「main」という名前のデフォルトのアクセスログフォーマットです。
このフォーマットは、リモート IP アドレス、リクエストボディ、アップストリームステータスなど、多くの情報を記録します。
「As default」は、このログフォーマットをそのネットワークパーティションのデフォルトアクセスログフォーマットとして設定することを意味します。アプリケーションでは、何も変更しない場合、デフォルトでこのログフォーマットが使用されます。
新しいフォーマットを追加したい場合は、このボタンをクリックします。
このチュートリアルでは、既存の「tutorial-example」フォーマットを使用します。
これはリクエスト時間、リモート IP アドレス、HTTP ホスト、リクエストボディを記録します。
サンプルアプリケーションのアクセスログを設定する
では、アプリケーションにこのアクセスログフォーマットを設定しましょう。
アプリケーションリストページに移動します。
以前のサンプルアプリケーション、test-edge.com を引き続き使用できます。
そのアプリケーションに入ります。
設定ページに移動します。
以前、このアプリケーションに「default」という名前のネットワークパーティションを設定しました。
このアプリケーションがデフォルトでグローバル設定のデフォルトアクセスログフォーマットを使用していることがわかります。
デフォルトのログフォーマットを使用している場合、アクセスログのファイル名を変更することはできません。
では、使用するログフォーマットを変更しましょう。「tutorial-example」という名前のアクセスログフォーマットを選択します。
これでログファイル名を変更できるようになりました。「example.access.log」に変更しましょう。
この変更を保存します。
いつものように、この新しい変更をプッシュするためにリリースする必要があります。
このボタンをクリックします。
リリースします！
変更がすべてのゲートウェイサーバーに同期されました。
これで、先ほどの変更がすべてのゲートウェイクラスターとサーバーにプッシュされました。
設定の変更にはサーバーのリロード、再起動、バイナリのアップグレードは必要ありません。そのため、非常に効率的でスケーラブルです。
アクセスログをテストする
以前のチュートリアルで、すでにアップストリームを定義しました。
この my_backend アップストリームは、バックエンドサーバーを 1 つ定義しています。
また、ページルールも定義しました。
このページルールは、先ほど見たアップストリームへのリバースプロキシを設定しています。
そのため、アプリケーションにアクセスすると、アップストリームのコンテンツが返されます。
では、アプリケーションがどのゲートウェイサーバーに属しているかを確認しましょう。
ゲートウェイクラスターページに移動します。
アプリケーションは “default” という名前のネットワークパーティションに属しています。
「default」という名前のネットワークパーティションに属する多くのゲートウェイクラスターがあることがわかります。
その中の1つを選んでアクセスログ情報を確認しましょう。
まず、アプリケーションにアクセスしてアクセスログメッセージを生成しましょう。
ターミナルで、curl を使用してリクエストを送信します。
curl -sSI -H 'Host: test-edge.com' http://52.53.251.226/
アクセスに成功しました！
次に、アクセスログ情報を確認しましょう。OpenResty Edge ゲートウェイサーバーにログインします。
example.access.log ファイルの最後のアクセスログ情報を確認します。
ログファイルディレクトリはグローバル設定で定義されています。
ログファイル名はアプリケーションで定義しました。
コマンドを実行します。
アクセスログ情報にリクエスト時間が含まれていることがわかります。
そしてリモート IP アドレス。
HTTP ホスト。
そしてリクエストボディ。
アクセスログ情報が「tutorial-example」アクセスログフォーマットと一致していることがわかります。
ちなみに、設定ページでアプリケーションのアクセスログフォーマットを設定する以外に、新しいアプリケーションを作成する際にも設定できます。
アプリケーションリストページに戻ります。
新しいアプリケーションボタンをクリックして、アクセスログフォーマットを設定できる場所を確認しましょう。
ここでアクセスログフォーマットを設定できます。
OpenResty Edge について
OpenResty Edge は、マイクロサービスと分散トラフィックアーキテクチャ向けに設計された多機能ゲートウェイソフトウェアで、当社が独自に開発しました。トラフィック管理、プライベート CDN 構築、API ゲートウェイ、セキュリティ保護などの機能を統合し、現代のアプリケーションの構築、管理、保護を容易にします。OpenResty Edge は業界をリードする性能と拡張性を持ち、高並発・高負荷シナリオの厳しい要求を満たすことができます。K8s などのコンテナアプリケーショントラフィックのスケジューリングをサポートし、大量のドメイン名を管理できるため、大規模ウェブサイトや複雑なアプリケーションのニーズを容易に満たすことができます。
著者について
章亦春（Zhang Yichun）は、オープンソースの OpenResty® プロジェクトの創始者であり、OpenResty Inc. の CEO および創業者です。
章亦春（GitHub ID: agentzh）は中国江蘇省生まれで、現在は米国ベイエリアに在住しております。彼は中国における初期のオープンソース技術と文化の提唱者およびリーダーの一人であり、Cloudflare、Yahoo!、Alibaba など、国際的に有名なハイテク企業に勤務した経験があります。「エッジコンピューティング」、「動的トレーシング」、「機械プログラミング」 の先駆者であり、22 年以上のプログラミング経験と 16 年以上のオープンソース経験を持っております。世界中で 4000 万以上のドメイン名を持つユーザーを抱えるオープンソースプロジェクトのリーダーとして、彼は OpenResty® オープンソースプロジェクトをベースに、米国シリコンバレーの中心部にハイテク企業 OpenResty Inc. を設立いたしました。同社の主力製品である OpenResty XRay動的トレーシング技術を利用した非侵襲的な障害分析および排除ツール）と OpenResty Edge（マイクロサービスおよび分散トラフィックに最適化された多機能
翻訳
英文版の原文と日本語訳版（本文）をご用意しております。読者の皆様による他の言語への翻訳版も歓迎いたします。全文翻訳で省略がなければ、採用を検討させていただきます。心より感謝申し上げます！
関連記事
OpenResty XRay May 28, 2023
OpenResty XRay Dec 21, 2023
OpenResty XRay Dec 4, 2023
OpenResty XRay Nov 23, 2023
OpenResty XRay Nov 21, 2023
