Upload usage data to Azure in indirect mode

Periodicamente, você pode exportar informações de uso. A exportação e o carregamento dessas informações criam e atualizam o controlador de dados e a instância gerenciada pelo SQL.

Aguarde pelo menos 24 horas após a criação do controlador de dados do Azure Arc antes de carregar dados de uso.

Criar entidade de serviço e atribuir funções

Antes de continuar, certifique-se de ter criado a entidade de serviço necessária e atribuí-la a uma função apropriada. Para obter mais detalhes, consulte:

• Crie uma entidade de serviço.
• Atribuir funções à entidade de serviço

Exemplos neste artigo usam colchetes < ... > angulares para identificar valores que você precisa substituir antes de executar o script. Substitua os colchetes e os valores dentro dos parênteses.

Carregar dados de utilização

Informações de uso, como inventário e uso de recursos, podem ser carregadas no Azure da seguinte maneira de duas etapas:

1. Exporte os dados de uso usando o comando, da az arcdata dc export seguinte maneira:

az arcdata dc export --type usage --path usage.json --k8s-namespace <namespace> --use-k8s

Este comando cria um usage.json arquivo com todos os recursos de dados habilitados para Azure Arc, como instâncias gerenciadas do SQL que são criadas no controlador de dados.

Por enquanto, o ficheiro não está encriptado para que possa ver o conteúdo. Sinta-se à vontade para abrir em um editor de texto e ver como é o conteúdo.

Você notará que há dois conjuntos de dados: resources e data. O resources são o controlador de dados e as Instâncias Gerenciadas SQL. Os resources registros nos dados capturam os eventos pertinentes no histórico de um recurso - quando ele foi criado, quando foi atualizado e quando foi excluído. Os data registros capturam quantos núcleos estavam disponíveis para serem usados por uma determinada instância para cada hora.

Exemplo de uma resource entrada:

    {
        "customObjectName": "<resource type>-2020-29-5-23-13-17-164711",
        "uid": "4bc3dc6b-9148-4c7a-b7dc-01afc1ef5373",
        "instanceName": "sqlInstance001",
        "instanceNamespace": "arc",
        "instanceType": "<resource>",
        "location": "eastus",
        "resourceGroupName": "production-resources",
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "isDeleted": false,
        "externalEndpoint": "32.191.39.83:1433",
        "vCores": "2",
        "createTimestamp": "05/29/2020 23:13:17",
        "updateTimestamp": "05/29/2020 23:13:17"
    }

Exemplo de uma data entrada:

        {
          "requestType": "usageUpload",
          "clusterId": "4b0917dd-e003-480e-ae74-1a8bb5e36b5d",
          "name": "DataControllerTestName",
          "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
          "resourceGroup": "production-resources",
          "location": "eastus",
          "uploadRequest": {
            "exportType": "usages",
            "dataTimestamp": "2020-06-17T22:32:24Z",
            "data": "[{\"name\":\"sqlInstance001\",
                       \"namespace\":\"arc\",
                       \"type\":\"<resource type>\",
                       \"eventSequence\":1, 
                       \"eventId\":\"50DF90E8-FC2C-4BBF-B245-CB20DC97FF24\",
                       \"startTime\":\"2020-06-17T19:11:47.7533333\",
                       \"endTime\":\"2020-06-17T19:59:00\",
                       \"quantity\":1,
                       \"id\":\"4BC3DC6B-9148-4C7A-B7DC-01AFC1EF5373\"}]",
           "signature":"MIIE7gYJKoZIhvcNAQ...2xXqkK"
          }
        }

2. Carregue os dados de uso usando o upload comando.

   az arcdata dc upload --path usage.json
   

Upload frequency

In the indirect mode, usage information needs to be uploaded to Azure at least once in every 30 days. É altamente recomendável fazer o upload com mais frequência, como diariamente. Se as informações de uso não forem carregadas após 32 dias, você verá alguma degradação no serviço, como a impossibilidade de provisionar novos recursos.

Haverá dois tipos de notificações para carregamentos de uso atrasados - fase de aviso e fase degradada. Na fase de aviso, haverá uma mensagem como Billing data for the Azure Arc data controller has not been uploaded in {0} hours. Please upload billing data as soon as possible..

Na fase degradada, a mensagem será semelhante Billing data for the Azure Arc data controller has not been uploaded in {0} hours. Some functionality will not be available until the billing data is uploaded.a .

A página Visão geral do portal do Azure para o Controlador de Dados e o status do Recurso Personalizado do Controlador de Dados em seu cluster kubernetes indicarão a data do último carregamento e a(s) mensagem(ões) de status.

Automatização de carregamentos (opcional)

Se quiser carregar métricas e logs de forma agendada, você pode criar um script e executá-lo em um temporizador a cada poucos minutos. Abaixo está um exemplo de automatização dos uploads usando um shell script Linux.

No seu editor de texto/código favorito, adicione o seguinte script ao arquivo e salve como um arquivo executável de script, como .sh (Linux/Mac) ou .cmd, .batou .ps1.

az arcdata dc export --type usage --path usage.json --force --k8s-namespace <namespace> --use-k8s
az arcdata dc upload --path usage.json

Tornar o arquivo de script executável

chmod +x myuploadscript.sh

Execute o script todos os dias para uso:

watch -n 1200 ./myuploadscript.sh

Você também pode usar um agendador de tarefas como cron ou Windows Task Scheduler ou um orquestrador como Ansible, Puppet ou Chef.

Related content

Carregar métricas e logs no Azure Monitor

Carregar logs no Azure Monitor

Carregue dados de cobrança no Azure e visualize-os no portal do Azure

Exibir o recurso do controlador de dados do Azure Arc no portal do Azure