Ops エージェントを使用して Apache からログを収集する

VM インスタンスを作成する

1. Google Cloud コンソールで [VM インスタンス] ページに移動します。

   [VM インスタンス] に移動

   このページを検索バーで検索する場合は、小見出しが「Compute Engine」の結果を選択します。

2. [インスタンスを作成] をクリックして、VM を作成します。ナビゲーション メニューのオプションを使用してインスタンスを構成します。
3. [マシンの構成] オプションで、次の操作を行います。
   1. [名前] フィールドにわかりやすい名前を入力します。
   2. [マシンタイプ] プリセット プルダウンで、[共有コア] > [e2-small] を選択します。
4. [OS とストレージ] オプションに [Debian GNU / Linux] と表示されていることを確認します。表示されていない場合は、[OS とストレージ] オプションをクリックし、[変更] をクリックします。[ブートディスク] ダイアログで、[バージョン] を [Debian GNU / Linux] に設定します。
5. [ネットワーキング] オプションの [ファイアウォール] で、[HTTP トラフィックを許可する] と [HTTPS トラフィックを許可する] の両方を選択します。
6. [オブザーバビリティ] オプションに [Ops エージェントをインストール] が表示されていることを確認します。表示されていない場合は、[オブザーバビリティ] オプションをクリックし、[モニタリングとロギング用の Ops エージェントをインストールする] を選択します。
7. [作成] をクリックします。

Apache ウェブサーバーをインストールする

Apache ウェブサーバーを Compute Engine VM インスタンスにインストールする手順は次のとおりです。

1. [VM インスタンス] ページで、新しい VM を見つけて [接続] 列に移動し、[SSH] をクリックします。

   接続できない場合は、SSH のトラブルシューティングをご覧ください。

2. パッケージ リストを更新するには、次のコマンドをクリップボードにコピーし、SSH ターミナルにコマンドを貼り付け、Enter キーを押します。

   sudo apt-get update
   

3. SSH ターミナルで、「Reading package lists...Done」というメッセージを確認した後、次のコマンドを実行して、Apache2 ウェブサーバーをインストールします。

   sudo apt-get install apache2 php7.0
   

   インストールを続行するように求められたら、「Y」と入力します。インストールのコマンドが失敗した場合、sudo apt-get install apache2 php を使用します。

4. コマンド プロンプトが返されたら、[VM インスタンス] ページに移動し、VM の外部 IP アドレスを次の URL にコピーします。

   http://EXTERNAL_IP
   

5. Apache ウェブサーバーに接続するには、新しいブラウザタブを開き、前のステップの URL を入力します。

   ウェブサーバーが正常にインストールされると、ブラウザタブに Apache2 Debian のデフォルト ページが表示されます。

   

Apache ウェブサーバーのログと指標を収集する

1. VM インスタンスの SSH ターミナルに移動します。ターミナルを開いていない場合は、次のようにします。

   1. Google Cloud コンソールで [VM インスタンス] ページに移動します。

      [VM インスタンス] に移動

      このページを検索バーで検索する場合は、小見出しが「Compute Engine」の結果を選択します。

   2. 新しい VM を見つけて、[SSH] をクリックします。

2. 次のコマンドをコピーして、インスタンスのターミナルに貼り付け、Enter キーを押します。

   # Configures Ops Agent to collect telemetry from the app. You must restart the agent for the configuration to take effect.
   
   set -e
   
   # Check if the file exists
   if [ ! -f /etc/google-cloud-ops-agent/config.yaml ]; then
     # Create the file if it doesn't exist.
     sudo mkdir -p /etc/google-cloud-ops-agent
     sudo touch /etc/google-cloud-ops-agent/config.yaml
   fi
   
   # Create a back up of the existing file so existing configurations are not lost.
   sudo cp /etc/google-cloud-ops-agent/config.yaml /etc/google-cloud-ops-agent/config.yaml.bak
   
   # Configure the Ops Agent.
   sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
   metrics:
     receivers:
       apache:
         type: apache
     service:
       pipelines:
         apache:
           receivers:
             - apache
   logging:
     receivers:
       apache_access:
         type: apache_access
       apache_error:
         type: apache_error
     service:
       pipelines:
         apache:
           receivers:
             - apache_access
             - apache_error
   EOF
   

   このコマンドにより、Apache ウェブサーバーからログと指標を収集して取り込むための構成が作成されます。詳細については、Apache ウェブサーバーの Ops エージェントを構成するをご覧ください。

3. Ops エージェントの再起動:
   1. エージェントを再起動するには、インスタンスで次のコマンドを実行します。

      sudo systemctl restart google-cloud-ops-agent
      

   2. エージェントが再起動したことを確認するには、次のコマンドを実行して「Metrics Agent」と「Logging エージェント」のコンポーネントが起動したことを確認します。

      sudo systemctl status "google-cloud-ops-agent*"
      

Apache ウェブサーバーのログを確認する

Google Cloud コンソールでログを表示するには、ログ エクスプローラを使用します。

1. Google Cloud コンソールで [ログ エクスプローラ] ページに移動します。

   [ログ エクスプローラ] に移動

   このページを検索バーで検索する場合は、小見出しが「Logging」の結果を選択します。

   最新のログが [クエリ結果] ペインに表示されます。

2. ツールバーで [クエリを表示] が有効になっていることを確認します。

3. Apache ウェブサーバーのログを表示するには、次のクエリを作成して実行します。

   1. Google Cloud プロジェクト セレクタから Google Cloud プロジェクトのリストを開き、Google Cloud プロジェクト ID をクリップボードにコピーします。

   2. 次の式で、コピーした ID を PROJECT_ID に貼り付け、クエリエディタにコピーします。

      resource.type="gce_instance"
      logName=("projects/PROJECT_ID/logs/apache_access" OR "projects/PROJECT_ID/logs/apache_error")
      

      前のクエリが実行されると、apache_access ログエントリと apache_error ログエントリのみが表示されます。

   3. [クエリを実行] をクリックします。

      [クエリ結果] ペインにクエリの結果が表示されます。

Apache ウェブサーバーからログと指標を収集するように Ops エージェントを構成し、それらのログを表示しました。次のステップでは、ログに特定のパターンが発生したときに通知するアラート ポリシーを作成します。

メール通知チャンネルを作成する

1. Google Cloud コンソールで、[notifications アラート] ページに移動します。

   [アラート] に移動

   このページを検索バーで検索する場合は、小見出しが「Monitoring」の結果を選択します。

2. ツールバーで [Edit Notification Channels] をクリックします。
3. [通知チャンネル] ページで [メール] までスクロールし、[新しく追加] をクリックします。
4. メールアドレス（表示名 My email など）を入力して、[保存] をクリックします。

ログベースのアラートを作成する

ログエントリに特定のメッセージが含まれているときに通知を受け取るには、ログベースのアラートを作成します。このセクションでは、ログエントリに「404 Not Found」というメッセージが含まれているときに通知されるよう、ログベースのアラートを作成します。

1. Google Cloud コンソールで [ログ エクスプローラ] ページに移動します。

   [ログ エクスプローラ] に移動

   このページを検索バーで検索する場合は、小見出しが「Logging」の結果を選択します。

2. [クエリ結果] ツールバーで、[add_alert アラートを作成] をクリックします。ログベースのアラート ポリシーのペインが開きます。

3. [アラートの詳細] で、[アラート ポリシー名] フィールドに「404 Not Found」と入力します。

4. [Choose logs to include in this alert] で、次の操作を行います。

   1. ログフィルタのテキスト ボックスにあるコンテンツをすべて削除します。

   2. 次のクエリをコピーして、ログフィルタ テキスト ボックスに貼り付けます。

      severity>=DEFAULT /help httpRequest.status=404
      

      以前のログフィルタでは、severity のレベルが DEFAULT 以上で、テキスト /help が含まれ、httpRequest ステータスが 404 のログエントリが検索されます。

5. [Set notification frequency and autoclose duration] セクションで、次のようにします。

   1. [通知の間隔] フィールドを [5 分] に設定します。
   2. [インシデントの自動クローズ期間] フィールドを [30 分] に設定します。

6. [通知するユーザーは？] で [通知チャンネル] メニューからメールアドレスを選択し、[保存] をクリックします。

アラート ポリシーをテストする

アラート ポリシーをテストするには、次の操作を行います。

1. VM インスタンスの SSH ターミナルに移動します。ターミナルを開いていない場合は、次のようにします。

   1. Google Cloud コンソールで [VM インスタンス] ページに移動します。

      [VM インスタンス] に移動

      このページを検索バーで検索する場合は、小見出しが「Compute Engine」の結果を選択します。

   2. 新しい VM を見つけて、[SSH] をクリックします。

2. サーバーで架空のページ localhost/help を検索するには、次のコマンドを実行します。

   curl localhost/help
   

   ターミナルに「404 Not Found」というメッセージが表示されると、メール通知が送信されます。このプロセスが完了するまで数分かかります。

   受信するメール通知は、次の例のようになります。

   

3. 新しいログエントリを表示するには、次のようにします。

   1. Google Cloud コンソールで [ログ エクスプローラ] ページに移動します。

      [ログ エクスプローラ] に移動

      このページを検索バーで検索する場合は、小見出しが「Logging」の結果を選択します。

   2. ツールバーで [現在の位置に移動] をクリックします。

Apache ウェブサーバーからログと指標を収集するように Ops エージェントを構成しましたが、まだログを表示しただけです。Apache ウェブサーバーの指標を表示する方法については、Ops エージェントを使用した Apache ウェブサーバーの指標の収集: トラフィックの生成をご覧ください。