Exportação

O App Center permite exportar continuamente todos os seus dados brutos do Analytics para o Azure. Você pode exportar dados do Analytics para Armazenamento de Blobs e Application Insights (Azure Monitor). Ao exportar os dados, você se beneficia de:

• Retenção ilimitada de dados
• Análise detalhada de uso
• Painel unificado
• Funcionalidades extensas adicionais do Application Insights, como funis de conversão, retenção

O App Center exporta continuamente dados do Google Analytics para o Application Insights a partir do momento em que você configura a exportação, juntamente com dois dias de dados preenchidos. Com o novo painel atualizado no Application Insights, os usuários do App Center podem obter uma visão unificada do Application e do Backend Analytics em um único painel.

O App Center exporta continuamente os dados do Google Analytics para o Armazenamento de Blobs a partir do momento em que você configura a exportação, juntamente com 28 dias de dados preenchidos. Saiba mais sobre o Armazenamento de Blobs

Você também pode exportar dados para o Blob de Armazenamento do Azure General Purpose v2. As contas de armazenamento v2 de uso geral dão suporte aos recursos mais recentes do Armazenamento do Azure e incorporam todas as funcionalidades das contas de armazenamento v1 e Blob de uso geral.

Saiba mais sobre o armazenamento de uso geral v2Saiba mais sobre o Application Insights

Armazenamento de Blobs do Azure

O Armazenamento de Blobs do Azure é um serviço para armazenar grandes quantidades de dados de objetos não estruturados, como texto ou dados binários, disponíveis em todo o mundo via HTTP ou HTTPS. Você pode usar o Armazenamento de Blob para expor dados publicamente ou para armazenar dados de forma privada.

Os dados são exportados a cada minuto e uma nova subpasta é criada a cada vez. Os dados são armazenados no formato ano/mês/dia/hora/minuto (por exemplo, https://<blob-storage-account>.blob.core.windows.net/archive/2017/12/09/04/03/logs.v1.data) por padrão quando o blob_path_format_kind é definido como WithoutAppId. Quando a config propriedade é definida como WithAppId, os dados são armazenados no formato appId/ano/mês/dia/hora/minuto , que prefixa o caminho padrão com o appID. Os dados levarão até 5 minutos para serem mostrados no Armazenamento de Blobs do Azure.

Os dados estão divididos em dados "Analytics" (sessões, eventos), "Falhas", "Erros" e "Anexos". Saiba mais sobre como exportar dados de diagnóstico

O conteúdo do ficheiro blob é um array JSON de registos de dispositivos de clientes, que se parece com isto para dados de Analytics:

[
    {
        "AppId": "00001111-aaaa-2222-bbbb-3333cccc4444",
        "Timestamp": "2017-12-09T04:02:53.618Z",
        "InstallId": "e589a371-ea0c-4479-9a7b-9f834adec040",
        "MessageType": "EventLog",
        "IngressTimestamp": "2017-12-09T04:02:57.987Z",
        "MessageId": "980e21a0-0cbb-48ac-8820-28acf4beb00d",
        "EventId": "ad980536-e743-48a9-ab7e-cb043602d2c9",
        "EventName": "log_out",
        "CorrelationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
        "IsTestMessage": "False",
        "SdkVersion": "1.0",
        "Model": "PC",
        "OemName": "Samsung",
        "OsName": "Android",
        "OsVersion": "8.1.0",
        "OsApiLevel": "2",
        "Locale": "EN",
        "TimeZoneOffset": "PT2M",
        "ScreenSize": "320x240",
        "AppVersion": "1.1.0",
        "AppBuild": "1",
        "AppNamespace": "com.microsoft.test",
        "CarrierName": "AT&T",
        "CarrierCountry": "US",
        "CountryCode": "US",
        "WrapperSdkVersion": "1.0",
        "WrapperSdkName": "mobilecenter.xamarin","Properties": "{\"extra_00\":\"5bcacf3598ca44ebbbc99e4488cfc854\",\"extra_01\":\"2673e48867c74d51af8dc24c762a8b28\",\"extra_02\":\"5b76c801e5074cd3a13ea37253b94484\",\"extra_03\":\"c1e76aa252c947d4b4bcd4d1d96a7be6\",\"extra_04\":\"caea50034c4f441a963700fa3cf70d03\"}",
        "SessionId": "10df497a-4261-4995-b466-3fd77ac47395",
        "SdkName": "mobilecenter.android",
        "OsBuild": "2",
        "WrapperRuntimeVersion": "None",
        "LiveUpdateDeploymentKey": "stage",
        "LiveUpdatePackageHash": "dsadsdasd3211321233",
        "LiveUpdateReleaseLabel": "2.0"
    }
]

Azure Application Insights

O Application Insights é um serviço de gerenciamento de desempenho de aplicativos (APM) que oferece recursos de consulta, segmentação, filtragem e análise de uso sobre seus dados de eventos do App Center. Ao adicionar o SDK do App Center ao seu aplicativo e exportar os dados para um recurso do Application Insights do tipo aplicativo do App Center, você terá acesso aos seguintes recursos:

• Análise do Application Insights. Use uma linguagem de consulta poderosa para analisar seus dados brutos de eventos e criar visualizações. Você pode exportar os resultados de suas consultas para o Power BI ou Excel.
• Usuários, sessões e eventos. Saiba quantas pessoas estão a utilizar cada página e funcionalidade da sua aplicação e, em seguida, segmente por país, navegador ou outras propriedades para perceber porquê.
• Funis e fluxos de usuários. Entenda como os usuários navegam pelo seu aplicativo. Identificar estrangulamentos. Descubra maneiras de aumentar as taxas de conversão e eliminar pontos problemáticos.
• Retenção. Descubra quantos usuários voltam a usar seu aplicativo. Descubra onde e por que eles desistem.
• Livro de Trabalho. Crie pastas de trabalho interativas que combinam visualizações de análise de uso, consultas do Application Insights Analytics e texto para compartilhar informações sobre sua equipe.

Os campos do App Center são mapeados no formato do Application Insights. Aqui está a equivalência entre os campos mapeados:

A tabela abaixo mostra o mapeamento de campo para o campo "customDimensions".

Um exemplo de consulta de IA para recuperar eventos personalizados:

customEvents
    | where name == "YourEventName"
    | extend Properties = todynamic(tostring(customDimensions.Properties))
    | extend YourPropertyName = Properties.YourPropertyName

Mais informações sobre o Application Insights e o App Center:

• Saiba mais sobre o Application Insights em geral
• Saiba mais sobre a integração com o App Center no blog AI
• Saiba mais sobre melhores decisões por meio do Better Analytics no blog do App Center

Pré-requisitos

Você deve ter uma Assinatura do Azure para usar a Exportação; Se você não tiver uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.

Vinculação de assinatura do Azure

A exportação padrão de dados do aplicativo do App Center para o Azure requer uma assinatura do Azure vinculada ao aplicativo do App Center. Adicionar a assinatura e vinculá-la a um aplicativo deve ser feito pelo proprietário do aplicativo (se o aplicativo não pertencer a uma organização) ou pelo administrador da organização.

Adicionar uma Subscrição do Azure

• Aplicação pertencente a uma organização: Se você for o administrador da organização, vá para a seção Gerenciar na organização à qual o aplicativo pertence.
• Aplicação pertencente a um utilizador: Se for o proprietário da aplicação, siga estes passos.

1. Faça login no portal do App Center.
2. Vá para as configurações do usuário.
3. Em Azure, clique em Adicionar assinatura
4. Selecione uma assinatura existente do Azure ou crie uma nova.

Vinculando um aplicativo a uma Assinatura do Azure

Depois de adicionar sua assinatura do Azure à conta de usuário ou organização, você precisa fornecer acesso aos aplicativos para que a assinatura possa ser usada nesse aplicativo. Ao fazer isso, você está permitindo que qualquer gerente/desenvolvedor nesse aplicativo use a assinatura para fins de exportação. Isso tem um custo associado cobrado em relação à sua Assinatura do Azure.

Configurar exportação

1. No portal do App Center, escolha o aplicativo.
2. Aceda às Definições da aplicação.
3. Clique em Exportar e selecione a opção Nova exportação .
4. Selecione armazenamento de blob ou Application Insights com base nas necessidades do seu aplicativo.
5. Selecione o tipo de configuração desejado (padrão vs personalizado).

O App Center oferece duas maneiras de exportar seus dados: exportação padrão e exportação personalizada. A exportação padrão permite exportar os dados com uma experiência de um clique, usando a assinatura do Azure vinculada ao aplicativo. A exportação personalizada fornecerá mais flexibilidade e as configurações serão personalizadas no Azure.

Exportação Padrão

A exportação padrão fornece uma experiência de um clique para exportar seus dados. Com essa opção, todos os recursos necessários são criados automaticamente no Azure.

Exportação Personalizada

A Exportação Personalizada permite que os usuários personalizem suas configurações de exportação no Azure.

Para Blob Storage

1. Inicie sessão no portal Azure.
2. Clique em Criar um novo recurso
3. Pesquise por Conta de armazenamento em Pesquisar no Marketplace.
4. Clique em Criar. Isso abre a página Criar conta de armazenamento.
5. Selecione uma Assinatura do Azure.
6. Escolha um grupo de recursos existente ou crie um novo. (Um grupo de recursos é um contêiner que contém recursos relacionados para uma solução do Azure)
7. Para tipos de conta, você verá a lista suspensa a seguir. Há três opções suportadas. Escolha o que é certo para si.
8. Clique em Rever + criar
9. Uma vez concluída a Validação
10. Clique em criar
11. Depois que a implantação for bem-sucedida, vá para o recurso
12. Localize Teclas de Acesso no separador 'Definições'
13. Copie a cadeia de conexão e adicione-a às configurações personalizadas do App Center.

Para o Application Insights

1. Inicie sessão no portal Azure.
2. Selecione Criar um recurso> Application Insights > Ferramentas de Gestão.
3. Será exibida uma caixa de configuração
4. Defina o Tipo de Aplicativo como Aplicativo do App Center.
5. Copie a chave de instrumentação do portal do Azure e adicione-a às suas configurações personalizadas do App Center. Você encontrará a chave de instrumentação na página Visão geral no recurso Application Insights.

Para obter mais informações sobre exportação, consulte o guia de início rápido do Application Insights.

Exportar várias aplicações para a mesma conta de armazenamento

Ao configurar a exportação para várias aplicações, deve-se criar ou atualizar uma configuração com a blob_path_format_kind (parte do modelo ExportBlobConfiguration) definida como WithAppId, que prefixa o caminho de exportação com os respetivos IDs das aplicações.

O caminho para o blob é formatado da seguinte forma:

• quando o enum é definido como WithoutAppId=false é year/month/day/hour/minute
• quando o enum é definido como WithAppId=true é appId/year/month/day/hour/minute

A API de criação de configuração de exportação foi descrita acima. Para configurações existentes, aqui está a API de atualização parcial:

PATCH /v0.1/apps/{owner_name}/{app_name}/export_configurations/{export_configuration_id}

As alterações levarão de 5 a 10 minutos para se propagar, e as entidades a partir desse ponto serão gravadas usando o novo formato de caminho.

Opção de autoexclusão por preenchimento a posteriori

Por padrão, uma nova configuração de exportação preencherá dois últimos dias de dados para recursos de IA e 30 dias para armazenamento de blobs. Há cenários em que o preenchimento não é necessário; por exemplo, caso isso resulte na substituição ou duplicação de dados. Nesse caso, defina a propriedade backfill com false ao criar uma nova configuração.

Escolher que tipo de dados exportar

Por padrão, uma nova configuração de exportação exporta apenas dados do Analytics (eventos, sessões e assim por diante) Os dados relacionados ao diagnóstico podem ser exportados definindo Entities a propriedade (export_entity model) para uma combinação de errors, crashese attachments. A propriedade também permite excluir dados do Google Analytics de serem exportados adicionando no_logs valor à Entities matriz.

Mecanismo de desativação automática

O App Center pode desativar automaticamente a configuração de exportação incorreta para evitar qualquer possível atraso em todo o pipeline de exportação. Por exemplo, o App Center lida com as falhas provenientes do Azure.

• A chave de instrumentação do Application Insights é inválida.
• O recurso de Blob não pode ser autenticado ou o nome remoto não pode ser resolvido.

GET  /v0.1​/apps​/{owner_name}​/{app_name}​/export_configurations
GET  /v0.1​/apps​/{owner_name}​/{app_name}​/export_configurations​/{export_configuration_id}

POST /v0.1​/apps​/{owner_name}​/{app_name}​/export_configurations​/{export_configuration_id}/enable

Preços

Para configurar a Exportar, você precisará criar uma assinatura do Azure. A exportação dos dados tem um custo associado que dependerá do serviço do Azure para o qual você está exportando. Encontre os detalhes sobre os preços de cada serviço em:

Preços do Application Insights

Preços do Armazenamento de Blobs