アクセスログ
注釈：本資料はAI技術を用いて翻訳されています。
概要
AccelByte Gaming Services (AGS) が提供する アクセスログ は、AGS からのトラフィックログを確認できるサービスです。AGS プラットフォームのエンドポイントに対してユーザー、プレイヤー、またはアプリケーションが行ったすべてのやり取りは、アクセスログサービスによってログに収集および保存され、それらのログは AGS Admin Portal でアクセスできます。各ログには、それを生成したイベントに関する詳細情報が含まれており、トラブルシューティング中に問題を特定するのに役立ちます。
権限
この権限セクションは、プライベートクラウドのお客様にのみ適用されます
権限 は、サービス内の特定のリソースへのアクセスを許可するために使用されます。Admin Portal でログにアクセスする前に、アカウントに次の権限があることを確認してください。
| 使用方法 | 権限 | アクション |
|---|---|---|
| ログのクエリ | ADMIN:NAMESPACE:{namespace}:LOG | READ |
権限は、IAM クライアント に割り当てられるか、ユーザーに割り当てられる ロール に割り当てられるかによって、動作が若干異なります。詳細については、AGS の 認可ドキュメント を参照してください。
Admin Portal でサービスログを表示する
ログを表示する
-
Admin Portal で、開きたいネームスペースを選択します。アクセスログはネームスペースの外側の Development Utilities メニューにあるため、理論的にはどのネームスペースからでもログにアクセスできます。実際には、アクセスログを使用すると、アクセス権のあるネームスペースのログのみが表示されます。
-
サイドバーで、Development Utilities メニュー > Access Logs に移動します。
-
Access Logs ページでは、アクセス権のあるすべてのネームスペースのすべてのログを表示できます。ログを見つけるには、ログリストを直接参照するか、ページの左側にあるフィルターを使用します。
- Request Time: リクエストが行われた時刻でフィルタリングします。Start Date フィールドと End Date フィールドにそれぞれ UTC 形式で開始時刻と終了時刻を入力することで、検索の時間範囲を定義できます。検索できる最大期間は 30 日間です。
ヒントデフォルトでは、ログ検索は Access Logs ページを開く前の 1 時間の結果に制限されます。古いログを検索する場合は、Start Date フィールドに以前の時刻を入力できます。
-
Log Type: ログのタイプでフィルタリングします。現在、ログには REST と WebSocket の 2 つのタイプがあります。WebSocket ログでフィルタリングする場合は、WebSocket Specific Filter も使用できます。
-
Show Internal Calls: このフィルターを切り替えて、検索に内部呼び出しを含めます。内部呼び出しは、ヘルスチェックや失効リストなど、ユーザーに価値を提供しない記録です。このフィルターは、デフォルトで内部呼び出しを含めるように切り替えられています。
-
一般的なフィルター:
-
Namespace: 検索を特定のネームスペースに制限します。空白のままにすると、検索で返されるログは、アクセス権のあるすべてのネームスペースから取得されます。
-
Service Name: 検索を特定のサービスに制限します。このフィルターを使用するには、表示されるボックスに目的のサービスの名前を入力します。サービス名は、次の表に従って入力する必要があります。
Service Name
Service Service Name Achievements achievement-service Analytics analytic Basic basic-service Cloud Storage cloud-storage Cloud Save cloudsave-service Config config-service Config Migration config-migration-service Dedicated Server Hub ds-hub-service GDPR gdpr-service Groups group-service IAM iam-service Leaderboards leaderboard-service Legal legal-service Lobby lobby-server Log log-service Login Queue login-queue-service Matchmaking matchmaking Platform platform-service Profanity Filter profanity-filter-service QOS Manager qos-manager-service QOS qos-service Reporting reporting-service Season Pass seasonpass-service Session Browser session-browser-service Social social-service Statistics statistic-service Turn Manager turn-manager-service User Generated Content (UGC) ugc-service -
User ID: 特定のユーザーまたはプレイヤーのアクティビティで検索をフィルタリングします。このフィルターを使用するには、表示されるボックスに目的のユーザーまたはプレイヤーの User ID を入力します。
-
Client ID: 特定のアプリケーションのアクティビティで検索をフィルタリングします。このフィルターを使用するには、表示されるボックスに目的のアプリケーションの Client ID を入力します。
-
Request Method: 特定のリクエストメソッドで検索をフィルタリングします。このフィルターを使用するには、ドロップダウンメニューから次のオプションのいずれかを選択します。
Request Method
Request Method GET PUT DELETE POST PATCH -
Response Status Code: 特定のレスポンスステータスコードで検索をフィルタリングします。このフィルターを使用するには、ドロップダウンメニューから次のオプションのいずれかを選択します。
Response Status Code
Response Status Code 200 OK 201 Created 202 Accepted 204 No Content 302 Found 307 Temporary Redirect 400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found 405 Method Not Allowed 406 Not Acceptable 08 Request Timeout 409 Conflict 412 Precondition Failed 413 Payload Too Large 415 Unsupported Media Type 422 Unprocessable Entity 429 Too Many Requests 500 Internal Server Error 502 Bad Gateway 503 Service Unavailable 504 Gateway Timeout -
Path: 特定のファイルパス (/platform/admin など) で検索をフィルタリングします。このフィルターを使用するには、表示されるボックスに目的のパスを入力します。
-
Source IP: 特定の IP アドレス で検索をフィルタリングします。このフィルターを使用するには、表示されるボックスに目的の IP アドレス を入力します。
-
Trace ID: 特定の trace ID で検索をフィルタリングします。このフィルターを使用するには、表示されるボックスに目的の ID を入力します。
ヒントリクエストの trace ID は、そのレスポンスヘッダーにあります。
- Referrer: ログが生成された特定のリファラーで検索をフィルタリングします。このフィルターを使用するには、表示されるボックスにリファラーの Web アドレスを入力します。
- Response Duration: 特定のレスポンス時間を持つログで検索をフィルタリングします。このフィルターを使用して、特に長いまたは短いレスポンス時間を持つログを検索できます。このフィルターを使用するには、Duration Option を選択し、次のサブフィールドから選択します。
Response Duration
レスポンス時間 Less Than More Than Between Less Than または More Than を選択した場合は、Duration フィールドにミリ秒単位で期間を入力します。Between を選択した場合は、Minimum Time フィールドに最短のレスポンス時間を、Maximum Time フィールドに最長のレスポンス時間を、両方ともミリ秒単位で入力します。
-
-
WebSocket 固有のフィルター:
-
Connection ID: 特定のユーザーの WebSocket Connection ID に基づいて検索をフィルタリングします。
NOTEユーザーまたはプレイヤーの WebSocket Connection ID は、AGS プラットフォームから切断して再接続するたびに変更されます。
-
Session ID: 特定のユーザーまたはプレイヤーのセッションの Session ID に基づいて検索をフィルタリングします。
-
Connection Stage: 接続ステージで検索をフィルタリングします。このフィルターを使用するには、ドロップダウンメニューから次のオプションのいずれかを選択します。
Connection Stage
Connection Stage Connect Disconnect Receive Send -
Close Code: 特定の close code で検索をフィルタリングします。このフィルターを使用するには、表示されるボックスに目的の close code を入力します。close code は、次の表に従って数値として入力する必要があります。
Close Code
Close Code Description 4000 disconnectCloseCode 4001 disconnectTokenRevokedCode 4002 disconnectServerClosedCode -
Message Type: メッセージタイプに基づいて検索をフィルタリングします。このフィルターを使用するには、表示されるボックスに目的のメッセージタイプを入力します。メッセージタイプは、次のように入力する必要があります。
Message Type
Message Type partyInfoRequest partyInfoResponse partyCreateRequest partyCreateResponse partyLeaveRequest partyLeaveResponse partyLeaveNotif partyInviteRequest partyInviteResponse partyInviteNotif partyGetInvitedNotif partyJoinRequest partyJoinResponse partyJoinNotif partyRejectRequest partyRejectResponse partyRejectNotif partyKickRequest partyKickResponse partyKickNotif personalChatRequest personalChatResponse personalChatNotif partyChatRequest partyChatResponse partyChatNotif personalChatHistoryRequest personalChatHistoryResponse partyPromoteLeaderRequest partyPromoteLeaderResponse partyGenerateCodeRequest partyGenerateCodeResponse partyGetCodeRequest partyGetCodeResponse partyDeleteCodeRequest partyDeleteCodeResponse partyJoinViaCodeRequest partyJoinViaCodeResponse partySendNotifRequest partySendNotifResponse partyNotif friendsStatusRequest friendsStatusResponse setUserStatusRequest setUserStatusResponse userStatusNotif clientResetRequest messageNotif startMatchmakingRequest startMatchmakingResponse cancelMatchmakingRequest cancelMatchmakingResponse matchmakingNotif setReadyConsentRequest setReadyConsentResponse setReadyConsentNotif rematchmakingNotif requestFriendsRequest requestFriendsResponse requestFriendsNotif listIncomingFriendsRequest listIncomingFriendsResponse listOutgoingFriendsRequest listOutgoingFriendsResponse acceptFriendsRequest acceptFriendsResponse acceptFriendsNotif rejectFriendsRequest rejectFriendsNotif rejectFriendsResponse cancelFriendsRequest cancelFriendsResponse cancelFriendsNotif unfriendRequest unfriendResponse unfriendNotif listOfFriendsRequest listOfFriendsResponse getFriendshipStatusRequest getFriendshipStatusResponse blockPlayerRequest blockPlayerResponse blockPlayerNotif unblockPlayerRequest unblockPlayerResponse unblockPlayerNotif getBlockedPlayerRequest getBlockedPlayerResponse createDSRequest createDSResponse waitForDSRequest claimDSRequest notifyDSRequest dsNotif systemComponentsStatus partyDataUpdateNotif joinDefaultChannelRequest joinDefaultChannelResponse userBannedNotification userUnbannedNotification exitAllChannel sendChannelChatRequest sendChannelChatResponse channelChatNotif setSessionAttributeRequest setSessionAttributeResponse getSessionAttributeRequest getSessionAttributeResponse getAllSessionAttributeRequest getAllSessionAttributeResponse signalingP2PNotif userMetricRequest userMetricResponse sendMatchResultNotif -
Message ID: 特定の Message ID で検索をフィルタリングします。
-
-
フィルターを選択したら、Apply Filter ボタンをクリックして検索を開始します。
-
ログファイルを選択して、その内容を展開します。
-
ログの Details タブでは、その特定のログを生成したアクティビティに関する情報を確認できます。
-
Request Body (REST)/Request Message (WebSocket) タブでは、ログで生成されたアクションのリクエストボディを確認できます。
-
Response Body (REST)/Response Message (WebSocket) タブでは、そのアクションへのレスポンスを確認できます。
-