Criar relatórios personalizados com o Power BI

Nesta secção, vai aprender a criar um relatório do Power BI sobre as APIs do Defender para Endpoint.

O primeiro exemplo demonstra como ligar o Power BI à API de Investigação Avançada e o segundo exemplo demonstra uma ligação às nossas APIs OData, como Ações de Máquina ou Alertas.

Ligar o Power BI à API de Investigação Avançada

1. Abra Microsoft Power BI.

2. Selecione Obter Dados>Em Branco Consulta.

   

3. Selecione Editor Avançado.

   

4. Copie o fragmento de código abaixo e cole-o no editor:

       let
           AdvancedHuntingQuery = "DeviceEvents | where ActionType contains 'Anti' | limit 20",
   
           HuntingUrl = "https://api.securitycenter.microsoft.com/api/advancedqueries",
   
           Response = Json.Document(Web.Contents(HuntingUrl, [Query=[key=AdvancedHuntingQuery]])),
   
           TypeMap = #table(
               { "Type", "PowerBiType" },
               {
                   { "Double",   Double.Type },
                   { "Int64",    Int64.Type },
                   { "Int32",    Int32.Type },
                   { "Int16",    Int16.Type },
                   { "UInt64",   Number.Type },
                   { "UInt32",   Number.Type },
                   { "UInt16",   Number.Type },
                   { "Byte",     Byte.Type },
                   { "Single",   Single.Type },
                   { "Decimal",  Decimal.Type },
                   { "TimeSpan", Duration.Type },
                   { "DateTime", DateTimeZone.Type },
                   { "String",   Text.Type },
                   { "Boolean",  Logical.Type },
                   { "SByte",    Logical.Type },
                   { "Guid",     Text.Type }
               }),
   
           Schema = Table.FromRecords(Response[Schema]),
           TypedSchema = Table.Join(Table.SelectColumns(Schema, {"Name", "Type"}), {"Type"}, TypeMap , {"Type"}),
           Results = Response[Results],
           Rows = Table.FromRecords(Results, Schema[Name]),
           Table = Table.TransformColumnTypes(Rows, Table.ToList(TypedSchema, (c) => {c{0}, c{2}}))
   
       in Table
   

5. Selecione Concluído.

6. Selecione Editar Credenciais.

   

7. Selecione Conta >organizacionalIniciar sessão.

   

8. Introduza as suas credenciais e aguarde até ter sessão iniciada.

9. Selecione Conectar.

   

Agora, os resultados da consulta são apresentados como uma tabela e pode começar a criar visualizações sobre a mesma! Pode duplicar esta tabela, mudar o nome da mesma e editar a consulta Investigação Avançada no interior para obter os dados que pretender.

Ligar o Power BI às APIs OData

A única diferença do exemplo anterior e este exemplo é a consulta dentro do editor.

1. Abra Microsoft Power BI.

2. Selecione Obter Dados>Em Branco Consulta.

   

3. Selecione Editor Avançado.

   

4. Copie o seguinte código e cole-o no editor para solicitar todas as Ações do Computador da sua organização:

       let
   
           Query = "MachineActions",
   
           Source = OData.Feed("https://api.securitycenter.microsoft.com/api/" & Query, null, [Implementation="2.0", MoreColumns=true])
       in
           Source
   

   Pode fazer o mesmo para Alertas e Computadores. Também pode utilizar consultas OData para filtros de consultas. Veja Utilizar Consultas OData.

Exemplos de dashboard do Power BI no GitHub

Veja os modelos de relatório do Power BI.

Artigos relacionados

• APIs do Defender para Endpoint
• API de Investigação Avançada
• Usar consultas de OData