Azure Functions のログを参照する - 闘うITエンジニアの覚え書き

# application insight コンポーネントの作成
az monitor app-insights component create \
    --app $insightsName \
    --location $insightsRegion \
    --resource-group $resourceGroup \
    --query-access Enabled \
    --retention-time $insightsDays \     ... 保持期間(日数) ※30,60,90,120,180,270,365,550,730　の何れか
    --subscription $subscriptionId

# 関数アプリの作成
az functionapp create \
  --name $funcAppName \
    :
  --app-insights $insightsName    <-- これ

カスタムハンドラを使用した関数アプリでは返却データに "Logs" としてログデータを含める事で Application Insight にログを渡す事が出来る。
※https://docs.microsoft.com/ja-jp/azure/azure-functions/functions-custom-handlers#response-payload

標準出力等に出力した内容も Application Insight には連携されるようだが、格納のされ方が若干異なる（後述）。

goのサンプル

    :

    logs := make([]string, 0)

    // 標準出力に表示
    fmt.Println("[INFO] This is std out message1.")
    fmt.Println("[INFO] This is std out message2.")

    // 戻り値(Logs)用の配列に追加
    logs = append(logs, "[INFO] Sample Log 1.")
    logs = append(logs, "[INFO] Sample Log 2.")

    :

    invokeResponse := InvokeResponse{Logs: logs, ReturnValue: string(returnValue)}  // 溜めたログを Logs として返却する
    js, err := json.Marshal(invokeResponse)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }   

    w.Header().Set("Content-Type", "application/json")
    w.Write(js)

ポータルからは対象の関数アプリの画面の [ログ] から検索画面に遷移する事ができる。
検索は Kustoというクエリ言語 で行うが、上記のようなログデータは　traces というテーブルから検索する事ができる。（Kustoについては後述）

[参考] tracesテーブルの定義内容 ... https://docs.microsoft.com/en-us/azure/azure-monitor/reference/tables/traces

他にも Insight のデータを探索する方法はいくつか用意されている。（主にメトリクス）
https://docs.microsoft.com/ja-jp/azure/azure-monitor/app/app-insights-overview#where-do-i-see-my-telemetry

Azure CLI で検索して JSON を取得する事も可能。

az monitor app-insights query --analytics-query 'Kustoクエリ式' --apps Insight名 -g リソースグループ名

例)

query='traces | where cloud_RoleName == "myfuncapp" and message has_cs "[INFO]" | sort by timestamp asc | project timestamp, message | take 2'
az monitor app-insights query --analytics-query "${query}" --apps Insight名 -g リソースグループ名

{
  "tables": [
    {
      "columns": [
        {
          "name": "timestamp",
          "type": "datetime"
        },
        {
          "name": "message",
          "type": "string"
        }
      ],
      "name": "PrimaryResult",
      "rows": [
        [
          "2020-08-27T18:12:00.0483909Z",
          "[INFO] This is std out message1."
        ],
        [
          "2020-08-27T18:12:00.0485376Z",
          "[INFO] This is std out message2."
        ]
      ]
    }
  ]
}

標準出力ログとLogに設定したログでは Application Insight への格納のされ方が異なる。

以下は、Insight でログを検索した結果だが、標準出力に出力したもの(1) には、operation_Name が設定されていない事が分かる。
関数アプリ内に複数の関数がある場合、operation_Name を見れば、どの関数から出力されたものかが分かるが、標準出力ログからは判断できない為、
標準出力ログをトレース等に利用する場合は、各ログに関数が識別出来る内容を含む。等の工夫が必要と思われる。