Métricas de VM - XBOX Game Development Documentation

As métricas de VM fornecem insights exclusivos sobre os recursos das máquinas virtuais (VMs) criadas como parte dos builds de VM do PlayFab quando você usa o PlayFab Multiplayer Servers para criar servidores de jogo multijogador. Esse recurso fornece acesso às métricas no nível do sistema da máquina virtual, como CPU, RAM e muito mais. Com essas métricas, você pode tomar decisões fundamentadas sobre como maximizar a utilização dos recursos da VM. As métricas de desempenho podem dar suporte a vários cenários de desenvolvimento.

Use os dados de utilização de CPU e memória para medir as necessidades de recursos dos servidores multijogador, para que você possa calcular corretamente o número ideal de servidores de jogo em um SKU (tipo) específico de máquina virtual
Use os contadores de rede para detectar um ambiente de rede irregular, como tentativas de ataques DDoS ou outros congestionamentos de rede

O serviço PlayFab Multiplayer Servers oferece suporte a um número limitado de métricas do sistema por meio do recurso VM Metrics.

Uso

As métricas de VM de um build podem ser habilitadas de duas maneiras, dependendo de como o build é criado:

Usando o Game Manager, você pode marcar a caixa de seleção “Virtual machine metrics” na página “New Build” do Game Manager.
Usando a API do PlayFab Multiplayer Servers, você pode definir a propriedade IsEnabled como TRUE nos seguintes objetos de API.

InstrumentationConfiguration na chamada à API CreateBuildWithManagedContainer para um build Windows com contêineres
InstrumentationConfiguration na chamada à API CreateBuildWithProcessBasedServer para um build Windows baseado em processo
LinuxInstrumentationConfiguration na chamada à API CreateBuildWithCustomContainer para um build Linux

Quando o recurso de métricas de VM é habilitado para um build, ele permanece habilitado durante todo o tempo de vida do build. Você não pode habilitar/desabilitar as métricas de VM de um build depois que ele é criado.

Windows

No Windows, a coleta de métricas de VM é um recurso do orquestrador de contêineres/processos existente do PlayFab, chamado VmAgent. O VmAgent executa periodicamente (a cada 10 segundos) uma tarefa que consulta os seguintes contadores de desempenho do sistema.

Megabytes disponíveis
% de tempo do processador
% de tempo do usuário
Leituras de disco/s (para a unidade D:)
Gravações de disco/s (para a unidade D:)
Bytes recebidos/s
Bytes enviados/s

Os valores coletados dos contadores são enviados ao nosso coletor de métricas interno em execução na VM. O coletor agrega esses valores e os envia ao nosso back-end interno para que possam ser apresentados ao usuário no Game Manager.

Linux

No Linux, usamos o agente de código aberto telegraf para coletar e processar métricas. O telegraf coleta métricas a cada 10 segundos e as emite para nosso agente coletor interno a cada 60 segundos. Para referência, você pode ver abaixo o conteúdo do arquivo de configuração telegraf.conf que usamos. Para obter mais detalhes, acesse a documentação oficial do telegraf. Também usamos um utilitário interno chamado telegraf-geneva-processor, que emite o valor da diferença para métricas no nível de contador, como a métrica net_bytes_recv. Emitir o valor da diferença em vez do valor real do contador resulta em uma visualização melhor nos gráficos fornecidos pelo Game Manager.

[agent]
  interval = "10s" 
  round_interval = true
  metric_batch_size = 1000
  metric_buffer_limit = 10000
  collection_jitter = "0s"
  flush_interval = "60s"
  flush_jitter = "0s"
  precision = ""
  debug = false
  omit_hostname = true
  
[global_tags]
  titleID = "TITLE_ID"
  buildID = "BUILD_ID"
  vmID = "VM_ID"

# consult man proc for details
# https://github.com/influxdata/telegraf/tree/master/plugins/inputs/cpu
[[inputs.cpu]]
  percpu = false
  totalcpu = true
  name_prefix = "telegraf_"
  fieldpass = ["usage_system", "usage_user"]

[[inputs.mem]] # https://www.linuxatemyram.com/
  fieldpass = ["available_percent"]
  name_prefix = "telegraf_"

[[inputs.net]] # /proc/net/dev
  fieldpass = ["bytes_sent", "bytes_recv"]
  name_prefix = "telegraf_"
  interfaces = ["eth0"]
  tagexclude = ["interface"]
  
# https://github.com/influxdata/telegraf/tree/master/plugins/inputs/diskio
[[inputs.diskio]] # /proc/diskstats
  fieldpass = ["reads", "writes"] # number of reads and writes on sdb device  
  devices = ["sdb"] # sdb device contains everything (including container storage) apart from /mnt
  name_prefix = "telegraf_" # which is the place where some of our shared folders are

# grab the allocated percentage from VmAgent. Be aware that this must be in influx format  
[[inputs.http]]
  urls = ["http://localhost:56001/v1/metrics/allocatedpercentage"]
  name_prefix = "telegraf_"
  data_format = "influx"
  tagexclude = ["url"]

# send all telegraf data to internal collector
[[outputs.socket_writer]]
  address = "unix:///var/etw/mdm_influxdb.socket"
  data_format = "influx"
  
# write this data to a file. This might be removed in the future  
[[outputs.file]]
  files = ["/tmp/PerformanceMetrics.csv"]
  data_format = "influx"
  rotation_max_size = "100MB"
  rotation_max_archives = 5
  
[[processors.execd]]
  command = [
    "/usr/bin/telegraf-geneva-processor", 
    "-configFile=/etc/telegraf/telegraf.geneva.processor.conf"
  ]

Essa configuração do telegraf.conf permite que o agente telegraf colete as métricas abaixo:

cpu_usage_system
cpu_usage_user
memory_available_percent
net_bytes_recv_diff (bytes de rede recebidos em eth0)
net_bytes_sent_diff (bytes de rede enviados em eth0)
diskio_reads_diff (número de leituras em sdb)
diskio_writes_diff (número de gravações em sdb)

Assim como no Windows, o telegraf envia os valores coletados dos contadores ao nosso coletor de métricas interno. O coletor agrega esses valores e os envia ao nosso back-end interno para que possam ser apresentados ao usuário no Game Manager.

Porcentagem de alocação

Nas VMs Windows e Linux, emitimos uma métrica chamada Allocation Percentage. O valor dessa métrica é calculado dividindo o número de servidores Active pelo número Total de servidores na VM. Essa métrica deve ser usada ao avaliar e interpretar os valores relatados das métricas do sistema. Isso ocorre porque o valor das métricas do sistema provavelmente será diferente em uma VM com muitos servidores Active em comparação com uma VM com muitos servidores StandingBy.

Exibindo as métricas de VM

Quando você habilita o recurso de métricas de VM para um novo build, as métricas são emitidas assim que o build é implantado com êxito. Você pode usar a página “Virtual Machines” (https://developer.playfab.com/en-US/<YOUR_TITLE_ID>/multiplayer/server/virtual-machines) no Game Manager para obter um link para exibir as métricas de VM de uma VM especificada. Você também pode acessar as métricas de VM selecionando seu build, indo para a guia de servidores, clicando no menu na linha da VM cujas métricas você deseja ver e selecionando “View Metrics”

Como posso enviar comentários sobre este recurso?

Junte-se a nós no Discord, no canal #multiplayer-servers; adoraríamos entrar em contato e ouvir sua opinião sobre este recurso!

Confira também

Arquivando e recuperando logs de servidores multijogador

​Uso

​Windows

​Linux

​Porcentagem de alocação

​Exibindo as métricas de VM

​Como posso enviar comentários sobre este recurso?

​Confira também

Uso