GCP에서 Laravel 로그를 StackDriver로 출력하려면

TL;DR

composer require codeinternetapplications/monolog-stackdriver

ENV 파일 설정

# 必須
LOG_CHANNEL=stackdriver

# インスタンス名別のログ保存する場合
GCP_LOG_RESOURCE_NAME=hoge_resource

# インスタンス(マシーン)単位のログ保存する場合
GCP_LOG_INSTANCE_ID=hoge_xxxxxx
GCP_LOG_PROJECT_ID=hoge_id
GCP_LOG_ZONE=hoge_zone

config/logging.php 설정

글로벌로 표시되도록 설정하는 경우

'channels' => [

    // ( ... )

    'stackdriver' => [
        'driver' => 'custom',
        'via' => CodeInternetApplications\MonologStackdriver\Laravel\CreateStackdriverLogger::class,
        'logName' => env('APP_NAME', 'my-project-log'),

        //GCP内部からの保存には必要ない
        // 'loggingClientOptions' => [
            // 'keyFilePath' => '/path/to/service-account-key-file.json',
        // ],

        // 'loggerOptions' => [],
        // 'lineFormat' => '%message%',
        // 'entryOptionsWrapper' => 'stackdriver',
    ],
]

인스턴스 이름별로 표시되도록 설정하는 경우

'channels' => [

    // ( ... )

    'stackdriver' => [
        'driver' => 'custom',
        'via' => CodeInternetApplications\MonologStackdriver\Laravel\CreateStackdriverLogger::class,
        'logName' => env('APP_NAME', 'my-project-log'),

        'loggerOptions' => [
              'labels' => [
                  'compute.googleapis.com/resource_name' => env('GCP_LOG_RESOURCE_NAME', 'dev-web-instance'),
              ],
              'resource' => [
                  'type' => 'gce_instance',
              ],
        ]

        //GCP内部からの保存には必要ない
        // 'loggingClientOptions' => [
            // 'keyFilePath' => '/path/to/service-account-key-file.json',
        // ],

        // 'loggerOptions' => [],
        // 'lineFormat' => '%message%',
        // 'entryOptionsWrapper' => 'stackdriver',
    ],
]

인스턴스(머신) 단위로 표시되도록 설정하는 경우

'channels' => [

    // ( ... )

    'stackdriver' => [
        'driver' => 'custom',
        'via' => CodeInternetApplications\MonologStackdriver\Laravel\CreateStackdriverLogger::class,
        'logName' => env('APP_NAME', 'my-project-log'),

        'loggerOptions' => [
              'labels' => [
                  'compute.googleapis.com/resource_name' => env('GCP_LOG_RESOURCE_NAME', 'dev-web-instance'),
              ],
              'resource' => [
                    'type' => 'gce_instance',
                    'labels' => [
                        'instance_id' =>  env('GCP_LOG_INSTANCE_ID'),
                        'project_id' =>  env('GCP_LOG_PROJECT_ID'),
                        'zone' =>  env('GCP_LOG_ZONE'),
                    ]
                ],
        ]

        //GCP内部からの保存には必要ない
        // 'loggingClientOptions' => [
            // 'keyFilePath' => '/path/to/service-account-key-file.json',
        // ],

        // 'loggerOptions' => [],
        // 'lineFormat' => '%message%',
        // 'entryOptionsWrapper' => 'stackdriver',
    ],
]

로그 전송

//infoレベルログ
Log::info('InfoLogInfoTest', ['logItem1' => 'メッセージはあとから分かりやすいものを', 'logItem2' => ['ItemSub1' => '配列形式で自由にデータを入れられる', 'ItemSub2' => '入れ子も問題なし'] ]);

// errorレベルログ
Log::error('InfoLogErrorTest', ['logItem1' => 'エラーもStackDriverで正しく識別', 'logItem2' => ['ItemSub1' => '配列形式で自由にデータを入れられる', 'ItemSub2' => '入れ子も問題なし'] ]);