Table of Contents

Estimativa e expansão de QPS

A concorrência é medida em QPS (Queries per second), ou seja, o número efetivo de solicitações de serviço recebidas pelo servidor por segundo. Independentemente de o posicionamento ser bem-sucedido ou não, desde que a solicitação contenha o AppId correto da biblioteca de localização em nuvem e passe na autenticação, ela será contabilizada nas estatísticas de concorrência.

Após a inicialização bem-sucedida, o dispositivo envia solicitações de posicionamento a uma frequência padrão de 1 vez por segundo. Devido a diferenças na latência da rede e no tempo de chegada das solicitações, pode ocorrer concorrência instantânea excedendo o limite de QPS. Por exemplo, 10 QPS podem teoricamente suportar 10 dispositivos, mas se mais de 10 solicitações forem recebidas no mesmo segundo, as solicitações excedentes serão rejeitadas. Para garantir a estabilidade do serviço em cenários de concorrência de múltiplos dispositivos, recomendamos que você reserve uma certa redundância ao adquirir QPS. Por exemplo, para suportar 10 dispositivos, você pode configurar 11–12 QPS.

O grupo de serviços de localização em nuvem fornece 10 concorrências por padrão, o que atende às necessidades da maioria dos cenários de aplicação. Para cenários de uso com maior concorrência, também oferecemos um plano flexível de expansão de recursos:

  • Durante períodos de alta concorrência, como feriados, você pode escolher pacotes de expansão de curto prazo para aumentar temporariamente a capacidade de concorrência
  • Para aplicativos com grande base de usuários que requerem suporte estável de alta concorrência, é possível vincular recursos de concorrência adicionais a longo prazo durante o período de validade do grupo de serviços em nuvem

Com base em 10 QPS, você pode escolher flexivelmente pacotes complementares de curto prazo ou aumentar a cota fixa de concorrência a longo prazo para se adaptar às necessidades de recursos em diferentes fases do negócio.

Comportamento quando a concorrência excede o limite

Quando as solicitações excedem instantaneamente o QPS alocado, o serviço retorna a seguinte mensagem de erro (exemplo):

statuCode: 21, message: "Exceed your QPS limitation"

Se usuários em estado de teste não conseguirem localizar, é provável devido à insuficiência de QPS. Recomendamos que você abra os logs através do Mega Toolbox para verificar a mensagem de resposta. Conforme mostrado na figura:

qps-limit

Nota

A cota de concorrência para usuários de teste é relativamente pequena. Ao não conseguir localizar, recomenda-se verificar se há mensagens de erro indicando exceder o limite.

Expansão de concorrência QPS

Você pode aumentar sua cota de concorrência de duas maneiras:

  • Consulta offline com vendas ou atendimento ao cliente (adequado para necessidades de grande escala, longo prazo ou personalizadas)
  • Atualização direta no console de gerenciamento online (adequado para expansões temporárias ou pequenas)

Atualização via consulta comercial offline

Quando a concorrência diária esperada exceder 50 QPS, recomendamos entrar em contato com vendas ou suporte da EasyAR para organizar a expansão de capacidade e garantia de recursos. Após a expansão, faça login no backoffice do desenvolvedor para confirmar se o limite entrou em vigor.

O processo para confirmar o limite de concorrência está destacado na figura abaixo:

Passos de operação:

  • Centro de desenvolvimento -> Block Localização em nuvem -> Grupo de serviços de localização em nuvem -> QPS atual

check-qps

Recomenda-se confirmar a quantidade de QPS após a atualização e o período de validade. Você pode verificar através da interface de gerenciamento da EasyAR, conforme explicado na próxima seção: Gerenciamento de concorrência QPS

Atualização online

O console possui dois pontos de entrada para atualizar o QPS online, conforme mostrado na figura abaixo:

  1. Centro de desenvolvimento -> Block Localização em nuvem -> Grupo de serviços de localização em nuvem -> Atualizar

  2. Centro de desenvolvimento -> Block Localização em nuvem -> Grupo de serviços de localização em nuvem -> Detalhes do QPS -> Atualizar

add-qps

Importante

Para necessidades de grande concorrência acima de 50 QPS, ainda é necessário consultar o setor comercial para garantir um fornecimento estável de recursos.

Gerenciamento de concorrência QPS

O gerenciamento de concorrência inclui principalmente:

  • Verificar a quantidade atual de QPS
  • Expansão de QPS
  • Atualização do período de validade de parte do QPS

Interface de gerenciamento

Passos de operação

  • Faça login no Centro de desenvolvimento -> Block Localização em nuvem -> Grupo de serviços de localização em nuvem -> Detalhes do QPS

Atualizar quantidade e validade do QPS

qps-manage

    Ao acessar os detalhes do QPS, a interface será conforme mostrado acima. A quantidade atual de QPS é exibida na área marcada no quadro direito da imagem.

    A linha do tempo no centro da interface mostra o período de validade da parte básica do QPS e da parte atualizada do QPS.

    Na parte inferior, o histórico de compras exibe detalhes dos pedidos de atualização e da validade.

Recomendações

  • Estime a concorrência de pico esperada, não a média, e reserve redundância para o pico (por exemplo, para um pico de 10 QPS, recomenda-se adquirir 11–12 QPS).
  • Durante feriados ou eventos, você pode adquirir temporariamente pacotes complementares de curto prazo para atender à alta demanda de concorrência.
  • Valide após a expansão: use o Mega Toolbox em cenários de alta concorrência para confirmar que as solicitações não foram rejeitadas e que a resposta está estável.
  • Se encontrar rejeições contínuas ou anormalidades, colete os logs e entre em contato com a equipe de suporte para investigação (incluindo janela de tempo, AppId da biblioteca de localização em nuvem e, se possível, forneça arquivos de captura contendo exemplos de solicitação e códigos de erro).

Próximo tópico

Explicação sobre expansão de capacidade e cotas de outros serviços Mega