影響のある機能
以下の基準を満たす場合は影響を受けます。- 2019年5月21日以前に作成されたテナント。
- AUまたはEU地域にあるAuth0のパブリッククラウドでホストされているテナント。
- パラメーター
include_totals=trueまたはqパラメーターで、GET /api/v2/logsまたはGET/api/v2/users/{user_id}/logsエンドポイントを使用している場合。 - 1000より多い結果をページネーションしている場合。
- 委任管理拡張機能を使用している場合。この拡張の旧バージョンは、テナントがログ検索エンジンv3に移行された後も機能し続けますが、ログを表示すると、ページネーションの統計が正しくないことに気づくでしょう。拡張のv3.7に更新することで、この問題に対処できます。
- US地域のクラウドテナント。US地域は、完全に移行されており、すでに検索エンジンv3を使用しています。
- プライベートクラウドのテナント（プライベートクラウドのお客様の移行は、後日開始します）。
-
EUおよびAU地域のクラウドテナントで、以下の場合：
- Management APIの
GET /api/v2/logsまたはGET /api/v2/users/{user_id}/logsエンドポイントをまったく使用していない。 - Dashboard Logsセクションのログのみを消費している。
- チェックポイントによるメソッドで（
fromパラメーターを使用して）GET /api/v2/logs endpointを使用している。 - 外部サービスのダッシュボード拡張（チェックポイントによるメソッドを使用する）へのAuth0ログのいずれかを使用して、ログを消費している場合。
- Management APIの
クエリ移行の確認
Auth0は、同じタイプと説明のログを1つだけ60分おきに生成します。廃止された機能を使用して影響を受けたエンドポイントを何回呼び出した場合でも、廃止された各機能に対し、1時間につき1つのログしか表示されません。 クエリに変更を加えた場合、新しいdepnoteログがないことが、廃止された動作がコードから削除されたことを意味するのかを最終的に判断するには、60分待つ必要があります。
v3への移行後にエラーをスローするクエリを探すために、以下でテナントログを検索できます。
type:depnote AND description:*logs*
これらのログエントリーは、使用している廃止動作を特定するdescriptionを含みます。
また、details.request.pathおよびclient_nameフィールドをチェックして、どのアプリケーションがGET /api/v2/logsかGET /api/v2/users/{user_id}/logsを呼び出しているか確認できます。
変更点
破壊的変更は少ないですが、結果が期待通りであることを確認するためにクエリを調べてください。 破壊的変更は、以下と関係しています。ページネーション
- テナントがログv3に移行されるとき、
GET /api/v2/logsまたはGET /api/v2/users/{user_id}/logsを呼び出したときに要約結果で返されるtotalフィールドの値は変更します。検索エンジンv2を使用してログを検索したとき、結果の合計フィールドは、提供したクエリに一致するログの数を伝えます。ただし、v3では、合計フィールドは、ページで返されたログの数を示します（フィールドが返す長さに似ている）。中断のリスクを避けるために、アプリケーションがページネーション目的で合計フィールドに依存する場合、この変更に適切に対応するためにロジックを更新する必要があります。 - 要求ごとに100ログという既存の制限があります。テナントがログv3に移行されると、最大1,000件の検索結果をページネーションでき、その結果1,000件を超える呼び出しはエラーを返します。中断のリスクを避けるために、この制限を回避する、またはそれに応じてエラーに対処するために、クエリを確認する必要があります。
qパラメーターの検証
- クエリ構文は、
GET /api/v2/logsでqパラメーターを使用した場合、考慮すべき若干の変更があります。テナントがログv3に移行されると、この検証が強制され、結果としてこのクエリがエラーを返します。中断のリスクを避けるために、クエリがサポートされているクエリ構文に従っていることを確認してください。 qパラメーターは、無効なフィールドを含んでいます。テナントがログv3に移行されると、この検証が強制され、結果としてこの呼び出しがエラーを返します。中断のリスクを避けるために、検索可能なフィールドのみが含まれているかクエリを確認してください。
テナントログ検索v3の有効化
クエリを確認したら、Dashboardを通してテナントログ検索エンジンv3をオプトインできます。- ［Tenant Settings（テナント設定）］>［Advanced（詳細設定）］に移動します。
- ［Migrations（移行）］ までスクロールします。
- 「Legacy Logs Search V2（旧式のログ検索V2）］ のトグルスイッチをオフに切り替えます。このスイッチをオフに切り替えると、廃止済みのログ検索エンジンv2を無効にし、検索エンジンｖ3の使用を強制します。「Legacy Logs Search V2（旧式のログ検索V2）］ トグルが表示されない場合は、すでにv3に移行済みです。これ以上のアクションは必要ありません。