ログの書き込みと表示

概要

リクエストがアプリケーションに送信されると、App Engine によってリクエストログが自動的に書き込まれます。リクエストの処理中には、アプリでアプリケーション ログを書き込むこともできます。このページでは、アプリケーションからアプリケーション ログを書き込む方法、Google Cloud コンソールでロギングを表示する方法、App Engine がリクエストの際に書き込むリクエストログ データを理解する方法について説明します。logs パッケージの内容を確認するには、logs パッケージのリファレンスをご覧ください。

ログデータをダウンロードする方法については、ログのエクスポートの概要をご覧ください。

リクエストログとアプリケーション ログ

ログデータには、リクエストログとアプリケーション ログの 2 つのカテゴリがあります。リクエストログは、アプリで処理される各リクエストごとに App Engine によって自動的に書き込まれ、プロジェクト ID、HTTP バージョンなどの情報が含まれます。リクエストログで使用可能なプロパティの一覧については、Record をご覧ください。リクエストログのフィールドの詳細については、リクエストログ一覧もご覧ください。

各リクエストログには、そのリクエストに関連付けられ、Record.AppLog フィールドで返されるアプリケーション ログ（AppLog）のリストが含まれます。各アプリケーション ログには、ログが書き込まれた時間、ログメッセージ、ログレベルが含まれます。

アプリケーション ログの書き込み

• デバッグ
• 警告
• 情報
• エラー
• 重大

次のスニペットは、ログエントリを書き込む方法を示しています。

import (
	"net/http"

	"google.golang.org/appengine"
	"google.golang.org/appengine/datastore"
	"google.golang.org/appengine/log"
)

func logHandler(w http.ResponseWriter, r *http.Request) {
	ctx := appengine.NewContext(r)

	post := &Post{Body: "sample post"}
	key := datastore.NewIncompleteKey(ctx, "Posts", nil)
	if _, err := datastore.Put(ctx, key, post); err != nil {
		log.Errorf(ctx, "could not put into datastore: %v", err)
		http.Error(w, "An error occurred. Try again.", http.StatusInternalServerError)
		return
	}
	log.Debugf(ctx, "Datastore put successful")

	w.Write([]byte("ok!"))
}

Google Cloud コンソールのログ URL の形式

Google Cloud コンソールのログ URL 形式の例については、次のサンプル URL をご覧ください。

https://console.cloud.google.com/logs?filters=request_id:000000db00ff00ff827e493472570001737e73686966746361727331000168656164000100

コンソールでのログの読み取り

スタンダード環境で実行されているアプリによって書き込まれたログを表示するには、ログ エクスプローラを使用します。

一般的な App Engine ログには、以下のサンプルログに示すとおり、Apache の Combined ログ形式のデータが特別な App Engine フィールドとともに含まれます。

192.0.2.0 - test [27/Jun/2014:09:11:47 -0700] "GET / HTTP/1.1" 200 414
"http://www.example.com/index.html"
Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/35.0.1916.153 Safari/537.36"
"1-dot-calm-sylph-602.appspot.com" ms=195 cpu_ms=42 cpm_usd=0.000046
loading_request=1 instance=00c61b117cfeb66f973d7df1b7f4ae1f064d app_engine_release=

リクエストログ フィールドについて

次の表に、フィールドとその説明を表示順に示します。

割り当てと上限

アプリケーションは次のログに関連する割り当ての影響を受けます。

• Logs API 経由で取得したログデータ
• ログ取り込み割り当てと保持

取得したデータの割り当て

Logs API 呼び出しで取得した最初の 100 MB/日のログデータは無料です。100 MB を超えるデータに $ 0.12/GB が課金されます。

ログの取得上限

App Engine アプリのロギングは、Google Cloud Observability によって行われます。ロギングのコストと上限の詳細については、Google Cloud Observability の料金をご覧ください。ログを長期間保存する場合は、Google Cloud Observability から Cloud Storage、BigQuery、Pub/Sub にログをエクスポートできます。

開発用サーバーと Logs API

デフォルトで、ログは開発用サーバーのメモリにのみ保存されます。Logs API 機能のテストを行う場合にアクセスできます。ログを開発用サーバーから任意の場所のディスクに保存するには、次のように、--logs_path コマンドライン オプションに必要なパスとファイル名を指定します。

   python2 [DEVAPPSERVER_ROOT]/google_appengine/dev_appserver.py --logs_path=your-path/your-logfile-name your-app-directory