Spec-Zone.ru › AWS CLI v2

[ aws . gamelift ]

describe-fleet-events

Описание

Получает записи из журнала событий флота. События флота инициируются изменениями статуса, например, во время создания и завершения работы флота, изменениями ёмкости и т. д. Если у флота несколько расположений, события также инициируются изменениями статуса и ёмкости в удалённых расположениях.

Вы можете указать диапазон времени, чтобы ограничить набор результатов. Используйте параметры постраничной навигации, чтобы получать результаты как набор последовательных страниц.

В случае успеха возвращается набор записей журнала событий, соответствующих запросу.

Дополнительная информация

Настройка флотов Amazon GameLift

См. также: Документацию API AWS

describe-fleet-events это постраничная операция. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничную навигацию, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной навигацией аргумент --query должен извлекать данные из результатов следующих выражений запроса: Events

Синтаксис

  describe-fleet-events
--fleet-id <value>
[--start-time <value>]
[--end-time <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--fleet-id (строка)

Уникальный идентификатор флота, для которого нужно получить журналы событий. Можно использовать либо идентификатор флота, либо значение ARN.

--start-time (метка времени)

Начальная дата для получения журналов событий. Если начальное время не указано, этот вызов возвращает записи, начиная с момента создания флота до указанного конечного времени. Формат — число, выраженное в Unix-времени в миллисекундах (например, "1469498468.057").

--end-time (метка времени)

Наиболее поздняя дата для получения журналов событий. Если конечное время не указано, этот вызов возвращает записи от указанного начального времени до текущего момента. Формат — число, выраженное в Unix-времени в миллисекундах (например, "1469498468.057").

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные в формате JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в формате JSON, так как строка будет принята буквально. Это не может быть указано вместе с --cli-input-yaml.

--starting-token (строка)

Токен, указывающий, где следует начать постраничную навигацию. Это NextToken из ранее усеченного ответа.

Примеры использования см. в разделе Постраничная навигация в Руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.

Примеры использования см. в разделе Постраничная навигация в Руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов, которые должны быть возвращены в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Чтобы продолжить постраничную навигацию, укажите значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе Постраничная навигация в Руководстве пользователя AWS Command Line Interface.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. При отсутствии значения или значении input выводит пример JSON-ввода, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, при указании yaml-input он выведет пример YAML-ввода, который можно использовать с --cli-input-yaml. При указании значения output он проверяет входные данные команды и возвращает пример JSON-вывода для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (булево)

Включить отладку регистрации.

--endpoint-url (строка)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого соединения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет стандартное поведение проверки сертификатов SSL.

--no-paginate (булево)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из файла с данными учетных данных.

--region (строка)

Использовать определённый регион. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

  • on
  • off
  • auto

--no-sign-request (булево)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Обработчик сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как закодированная строка base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого файла, отображающего двоичный блок, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла напрямую, независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (булево)

Отключить кли-паджинг для вывода.

--cli-auto-prompt (булево)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запросы параметров ввода CLI.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. См. руководство по началу работы в Руководстве пользователя AWS CLI для получения дополнительной информации.

Если не указано иное, все примеры имеют правила цитирования, подобные правилам Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной программы. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Для запроса событий за указанный период времени

Следующий describe-fleet-events пример отображает подробности всех событий, связанных с флотом, которые произошли в течение указанного временного интервала.

aws gamelift describe-fleet-events \
    --fleet-id arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
    --start-time 1579647600 \
    --end-time 1579649400 \
    --limit 5

Вывод:

{
    "Events": [
        {
            "EventId": "a37b6892-5d07-4d3b-8b47-80244ecf66b9",
            "ResourceId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "EventCode": "FLEET_STATE_ACTIVE",
            "Message": "Fleet fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 changed state to ACTIVE",
            "EventTime": 1579649342.191
        },
        {
            "EventId": "67da4ec9-92a3-4d95-886a-5d6772c24063",
            "ResourceId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "EventCode": "FLEET_STATE_ACTIVATING",
            "Message": "Fleet fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 changed state to ACTIVATING",
            "EventTime": 1579649321.427
        },
        {
            "EventId": "23813a46-a9e6-4a53-8847-f12e6a8381ac",
            "ResourceId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "EventCode": "FLEET_STATE_BUILDING",
            "Message": "Fleet fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 changed state to BUILDING",
            "EventTime": 1579649321.243
        },
        {
            "EventId": "3bf217d0-1d44-42f9-9202-433ed475d2e8",
            "ResourceId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "EventCode": "FLEET_STATE_VALIDATING",
            "Message": "Fleet fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 changed state to VALIDATING",
            "EventTime": 1579649197.449
        },
        {
            "EventId": "2ecd0130-5986-44eb-99a7-62df27741084",
            "ResourceId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "EventCode": "FLEET_VALIDATION_LAUNCH_PATH_NOT_FOUND",
            "Message": "Failed to find a valid path",
            "EventTime": 1569319075.839,
            "PreSignedLogUrl": "https://gamelift-event-logs-prod-us-west-2.s3.us-west-2.amazonaws.com/logs/fleet-83422059-8329-42a2-a4d6-c4444386a6f8/events/2ecd0130-5986-44eb-99a7-62df27741084/FLEET_VALIDATION_LAUNCH_PATH_NOT_FOUND.txt?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEB8aCXVzLXdlc3QtMiJHMEUCIHV5K%2FLPx8h310D%2FAvx0%2FZxsDy5XA3cJOwPdu3T0eBa%2FAiEA1yovokcZYy%2FV4CWW6l26aFyiSHO%2Bxz%2FBMAhEHYHMQNcqkQMImP%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARAAGgw3NDEwNjE1OTIxNzEiDI8rsZtzLzlwEDQhXSrlAtl5Ae%2Fgo6FCIzqXPbXfBOnSvFYqeDlriZarEpKqKrUt8mXQv9iqHResqCph9AKo49lwgSYTT2QoSxnrD7%2FUgv%2BZm2pVuczvuKtUA0fcx6s0GxpjIAzdIE%2F5P%2FB7B9M%2BVZ%2F9KF82hbJi0HTE6Y7BjKsEgFCvk4UXILhfjtan9iQl8%2F21ZTurAcJbm7Y5tuLF9SWSK3%2BEa7VXOcCK4D4O1sMjmdRm0q0CKZ%2FIaXoHkNvg0RVTa0hIqdvpaDQlsSBNdqTXbjHTu6fETE9Y9Ky%2BiJK5KiUG%2F59GjCpDcvS1FqKeLUEmKT7wysGmvjMc2n%2Fr%2F9VxQfte7w9srXwlLAQuwhiXAAyI5ICMZ5JvzjzQwTqD4CHTVKUUDwL%2BRZzbuuqkJObZml02CkRGp%2B74RTAzLbWptVqZTIfzctiCTmWxb%2FmKyELRYsVLrwNJ%2BGJ7%2BCrN0RC%2FjlgfLYIZyeAqjPgAu5HjgX%2BM7jCo9M7wBTrnAXKOFQuf9dvA84SuwXOJFp17LYGjrHMKv0qC3GfbTMrZ6kzeNV9awKCpXB2Gnx9z2KvIlJdqirWVpvHVGwKCmJBCesDzjJHrae3neogI1uW%2F9C6%2B4jIZPME3jXmZcEHqqw5uvAVF7aeIavtUZU8pxpDIWT0YE4p3Kriy2AA7ziCRKtVfjV839InyLk8LUjsioWK2qlpg2HXKFLpAXw1QsQyxYmFMB9sGKOUlbL7Jdkk%2BYUq8%2FDTlLxqj1S%2FiO4TI0Wo7ilAo%2FKKWWF4guuNDexj8EOOynSp1yImB%2BZf2Fua3O44W4eEXAMPLE33333&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20170621T231808Z&X-Amz-SignedHeaders=host&X-Amz-Expires=900&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20170621%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Signature=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
        }
    ],
    "NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE2"
}

Дополнительную информацию см. в разделе Отладка проблем с флотом GameLift в Руководстве разработчика Amazon GameLift.

Вывод

События -> (список)

Коллекция объектов, содержащих записи журналов событий для указанного флота.

(структура)

Запись журнала, описывающая событие, связанное с ресурсами Amazon GameLift (такими как флот). Помимо отслеживания активности, коды событий и сообщения могут предоставлять дополнительную информацию для устранения неполадок и отладки проблем.

EventId -> (строка)

Уникальный идентификатор события флота.

ResourceId -> (строка)

Уникальный идентификатор ресурса события, например, ID флота.

EventCode -> (строка)

Тип регистрируемого события.

События перехода состояния флота:
  • FLEET_CREATED – Ресурс флота был успешно создан со статусом NEW . Сообщение события включает ID флота.
  • FLEET_STATE_DOWNLOADING – Состояние флота изменилось с NEW на DOWNLOADING . Amazon GameLift загружает сжатый билдер и выполняет скрипты установки.
  • FLEET_STATE_VALIDATING – Состояние флота изменилось с DOWNLOADING на VALIDATING . Amazon GameLift успешно установил билдер и теперь проверяет файлы билдера.
  • FLEET_STATE_BUILDING – Состояние флота изменилось с VALIDATING на BUILDING . Amazon GameLift успешно проверил файлы билдера и теперь запускает экземпляр флота.
  • FLEET_STATE_ACTIVATING – Состояние флота изменилось с BUILDING на ACTIVATING . Amazon GameLift запускает процесс сервера игры на экземпляре флота и тестирует его подключение к сервису Amazon GameLift.
  • FLEET_STATE_ACTIVE – Состояние флота изменилось с ACTIVATING на ACTIVE . Флот теперь готов принимать игровые сессии.
  • FLEET_STATE_ERROR – Состояние флота изменилось на ERROR . Подробное описание см. в сообщении события флота.
События создания флота (в порядке создания):
  • FLEET_BINARY_DOWNLOAD_FAILED – Загрузка билдера в экземпляр флота не удалась.
  • FLEET_CREATION_EXTRACTING_BUILD – Билдер сервера игры был успешно загружен в экземпляр, и Amazon GameLift теперь извлекает файлы билдера из загруженного билдера. Ошибка на этом этапе препятствует переходу флота в состояние ACTIVE. Логи на этом этапе отображают список извлечённых и сохранённых на экземпляре файлов. Доступ к логам можно получить, используя URL в PreSignedLogUrl .
  • FLEET_CREATION_RUNNING_INSTALLER – Файлы билдера сервера игры были успешно извлечены, и Amazon GameLift теперь выполняет скрипт установки билдера (если он есть). Ошибка на этом этапе препятствует переходу флота в состояние ACTIVE. Логи на этом этапе отображают шаги установки и успешность её завершения. Доступ к логам можно получить, используя URL в PreSignedLogUrl .
  • FLEET_CREATION_COMPLETED_INSTALLER – Файлы билдера сервера игры были успешно установлены, и вскоре начнется валидация установки.
  • FLEET_CREATION_FAILED_INSTALLER – Установка билдера сервера игры завершилась неудачно при попытке установить файлы билдера. Это событие указывает, что ошибка произошла до того, как Amazon GameLift смог начать валидацию.
  • FLEET_CREATION_VALIDATING_RUNTIME_CONFIG – Процесс билдера завершился успешно, и GameLift теперь проверяет существование путей запуска сервера игры, указанных в конфигурации времени выполнения флота. Если какой-либо указанный путь запуска существует, Amazon GameLift пытается запустить процесс сервера игры и ожидает сообщения о готовности. Ошибки на этом этапе препятствуют переходу флота в состояние ACTIVE . Логи на этом этапе отображают пути запуска в конфигурации времени выполнения и указывают, найден ли каждый путь. Доступ к логам можно получить, используя URL в PreSignedLogUrl .
  • FLEET_VALIDATION_LAUNCH_PATH_NOT_FOUND – Проверка конфигурации времени выполнения завершилась неудачно, потому что исполняемый файл, указанный в пути запуска, не существует на экземпляре.
  • FLEET_VALIDATION_EXECUTABLE_RUNTIME_FAILURE – Проверка конфигурации времени выполнения завершилась неудачно, потому что исполняемый файл, указанный в пути запуска, не смог запуститься на экземпляре флота.
  • FLEET_VALIDATION_TIMED_OUT – Проверка флота в конце создания истекла. Повторите создание флота.
  • FLEET_ACTIVATION_FAILED – Флот не смог успешно завершить один из шагов процесса активации флота. Этот код события указывает, что билдер игры был успешно загружен на экземпляр флота, собран и проверен, но не смог запустить процесс сервера. Для получения дополнительной информации см. Debug Fleet Creation Issues .
  • FLEET_ACTIVATION_FAILED_NO_INSTANCES – Создание флота не смогло получить ни одного экземпляра на основе входных атрибутов флота. Повторите попытку в другое время или выберите другую комбинацию атрибутов флота, таких как тип флота, тип экземпляра и т. д.
  • FLEET_INITIALIZATION_FAILED – Во время создания флота произошла общая ошибка. Подробное описание см. в сообщении события флота.
События peering VPC:
  • FLEET_VPC_PEERING_SUCCEEDED – Установлено соединение VPC peering между VPC для флота Amazon GameLift и VPC в вашей учётной записи Amazon Web Services.
  • FLEET_VPC_PEERING_FAILED – Запрошенное соединение VPC peering завершилось неудачно. Подробное описание и информация о статусе предоставляют дополнительные сведения. Распространённой причиной неудачи peering является то, что два VPC имеют перекрывающиеся CIDR-блоки IPv4-адресов. Для решения этой проблемы измените CIDR-блок VPC в вашей учётной записи Amazon Web Services. Дополнительную информацию об ошибках VPC peering см. на сайте https://docs.aws.amazon.com/AmazonVPC/latest/PeeringGuide/invalid-peering-configurations.html
  • FLEET_VPC_PEERING_DELETED – Соединение VPC peering успешно удалено.
События экземпляров Spot:
  • INSTANCE_INTERRUPTED – Экземпляр Spot был прерван EC2 с уведомлением в течение двух минут.
  • INSTANCE_RECYCLED – Экземпляр Spot был признан высоким риском прерывания и запланирован на переработку, как только на нём не будет активных игровых сессий.
События процессов сервера:
  • SERVER_PROCESS_INVALID_PATH – Исполняемый файл или скрипт сервера игры не найден на основе конфигурации времени выполнения флота. Проверьте корректность пути запуска в зависимости от операционной системы флота.
  • SERVER_PROCESS_SDK_INITIALIZATION_TIMEOUT – Процесс сервера не выполнил InitSDK() в течение ожидаемого времени (5 минут). Проверьте ваш журнал игровой сессии, чтобы понять, почему InitSDK() не был выполнен вовремя. Это событие не генерируется для управляемых контейнерных флотов и флотов Anywhere, если они не развернуты с Amazon GameLift Agent.
  • SERVER_PROCESS_PROCESS_READY_TIMEOUT – Процесс сервера не выполнил ProcessReady() в течение ожидаемого времени (5 минут) после выполнения InitSDK() . Проверьте ваш журнал игровой сессии, чтобы понять, почему ProcessReady() не был выполнен вовремя.
  • SERVER_PROCESS_CRASHED – Процесс сервера завершился без выполнения ProcessEnding() . Проверьте ваш журнал игровой сессии, чтобы понять, почему ProcessEnding() не был выполнен.
  • SERVER_PROCESS_TERMINATED_UNHEALTHY – Процесс сервера слишком долго не сообщал о корректной проверке состояния и поэтому был завершен GameLift. Проверьте ваш журнал игровой сессии, чтобы убедиться, что поток не застрял при обработке синхронной задачи слишком долго.
  • SERVER_PROCESS_FORCE_TERMINATED – Процесс сервера не завершился корректно в ожидаемое время после того, как был отправлен OnProcessTerminate() . Проверьте ваш журнал игровой сессии, чтобы понять, почему завершение заняло больше времени, чем ожидалось.
  • SERVER_PROCESS_PROCESS_EXIT_TIMEOUT – Процесс сервера не завершился корректно в течение ожидаемого времени (30 секунд) после вызова ProcessEnding() . Проверьте ваш журнал игровой сессии, чтобы понять, почему завершение заняло больше времени, чем ожидалось.
События игровых сессий:
  • GAME_SESSION_ACTIVATION_TIMEOUT – Игровая сессия не активировалась в течение ожидаемого времени. Проверьте ваш журнал игровой сессии, чтобы понять, почему ActivateGameSession() заняло больше времени, чем ожидалось.
Другие события флота:
  • FLEET_SCALING_EVENT – Были внесены изменения в настройки ёмкости флота (желаемые экземпляры, минимальные/максимальные пределы масштабирования). Сообщение события включает новые настройки ёмкости.
  • FLEET_NEW_GAME_SESSION_PROTECTION_POLICY_UPDATED – Были внесены изменения в политику защиты игровых сессий флота. Сообщение события включает как старую, так и новую политику.
  • FLEET_DELETED – Инициирован запрос на удаление флота.
  • GENERIC_EVENT – Произошло неопределённое событие.

Message -> (строка)

Дополнительная информация, связанная с событием.

EventTime -> (временная метка)

Временная метка, указывающая, когда произошло это событие. Формат – число, выраженное в миллисекундах времени Unix (например "1469498468.057").

PreSignedLogUrl -> (строка)

Расположение хранящихся журналов с дополнительными подробностями, связанными с событием. Это полезно для отладки проблем. URL-адрес действителен в течение 15 минут. Вы также можете получить доступ к журналам создания флота через консоль Amazon GameLift.

Count -> (длинное целое число)

Количество раз, когда произошло это событие.

NextToken -> (строка)

Токен, указывающий, где продолжить получение результатов при следующем вызове этой операции. Если токен не возвращен, эти результаты представляют собой конец списка.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API