Simple Log Service:StoreView overview

O que é um StoreView

Um StoreView é um recurso virtual em um projeto do SLS que mapeia relacionamentos entre Logstores ou Metricstores. Esse recurso permite consultar dados em vários stores, mas não modificá-los. Existem dois tipos: o StoreView for Logstore, compatível com consulta, análise e predefinição com sintaxe SPL; e o StoreView for Metricstore, destinado exclusivamente a consultas entre Metricstores.

Em uma Log Data View ou Time Series Data View, visualize dados em vários Logstores ou Metricstores. Por exemplo, se Logstore1 e Logstore2 contiverem um campo age e estiverem associados no Storeview1, uma consulta ao campo age no Storeview1 retornará resultados correspondentes de ambos.

Permissões

Usuários e funções do RAM exigem permissões explícitas para usar um StoreView. Para obter detalhes, consulte Create a RAM user and grant permissions, Create a RAM role for an Alibaba Cloud service and grant permissions to the RAM role e Use a RAM role for cross-account resource access.

Conceda permissões usando uma system policy ou uma custom policy.

• System policy: Predefinida pela Alibaba Cloud. Use essas políticas sem possibilidade de modificação.

  • Permissões somente leitura para o Simple Log Service: AliyunLogReadOnlyAccess.

  • Permissões totais de gerenciamento para o Simple Log Service: AliyunLogFullAccess.

• Custom policy: Políticas definidas pelo usuário, criadas e gerenciadas por você.

  • Para criar um StoreView ou consultar dados como usuário ou função do RAM, obtenha permissão para query logs in a Logstore em todos os Logstores e Metricstores associados. Adicione a seguinte instrução à sua política personalizada:

    Importante

    • Em uma política, Logstore pode se referir a um Logstore ou a um Metricstore.

    • Em uma política, storeview pode se referir tanto a uma Log Data View quanto a uma Time Series Data View.

    {
      "Version": "1",
      "Statement": [
        {
          "Action": "log:GetLogStoreLogs",
          "Resource":[
            "acs:log:*:*:project/${projectName}/Logstore/*",
            "acs:log:*:*:project/${projectName}/storeview/*"
          ],
          "Effect": "Allow"
        }
      ]
    }

Limitações

• Limite de até 10 Log Data View ou Time Series Data View por projeto do Simple Log Service.

• Cada Log Data View ou Time Series Data View aceita associação com, no máximo, 50 Logstores ou Metricstores.

• Todos os Logstores ou Metricstores em uma Log Data View ou Time Series Data View devem pertencer à mesma conta da Alibaba Cloud.

• Os Storeviews oferecem suporte a análises entre regiões apenas na China continental. Não há suporte para análises transfronteiriças.

Predefinição

Conceito

Ao criar um StoreView for Logstore, anexe instruções SPL predefinidas para filtrar dados ou alinhar nomes de campos antes da agregação. Consultas predefinidas aceitam apenas SPL commands and functions e as palavras-chave de SPL commands and functions. Por exemplo, para agregar o campo a do LogStore1 e o campo b do LogStore2, use extend a = b para alinhar os nomes das colunas. Example.

Limitações

A predefinição é compatível apenas com StoreView for Logstore, não se aplicando ao StoreView for Metricstore.

Comandos suportados

Consultas predefinidas aceitam os operadores listados em SPL commands and functions e SPL commands and functions.

Para funções SQL e SPL, consulte Function overview.

Exemplos

Para criar ou modificar um StoreView for Logstore, consulte Create a Storeview for Logstore.

Por exemplo, se precisar agregar o campo a do Logstore1 e o campo b do Logstore2, utilize extend a = b (predefinição) ao criar ou modificar um storeview para uniformizar os nomes das colunas.

Exemplo 1

Se você predefinir * | where a>1 no Logstore1, apenas os logs no StoreView correspondentes a a>1 serão incluídos na análise subsequente.

A consulta real é * | where cast(a as integer) > 1. A tabela de visualização de dados mostra que os valores de a nos logs filtrados são 10 e 9, ambos maiores que 1.

Exemplo 2

No Logstore1, predefinir * | extend b = a adiciona uma coluna chamada b ao Logstore1 dentro do StoreView. Essa coluna possui os mesmos valores da coluna a e serve para agregações posteriores.

Após a predefinição de extend b = a, a tabela de visualização de dados exibe a nova coluna b adicionada ao Logstore1, com valores idênticos aos da coluna a.

Consulta

Storeview for Logstore

Um StoreView for Logstore consulta dados em múltiplos Logstores simultaneamente. Por exemplo, se uma Log Data View estiver associada ao LogStore-1 e ao LogStore-2, e ambos contiverem o campo request_method, a consulta (request_method:GET or request_method:POST) and status in [200 299] retorna logs correspondentes de ambas as fontes. Para sintaxe de consulta, consulte Query syntax and features.

Caso uma Log Data View contenha dois Logstores com conteúdo de log idêntico, uma busca por palavra-chave retornará resultados de ambos. Utilize o campo de tag para identificar o Logstore de origem de cada entrada de log.

Nos resultados da consulta, cada log é identificado pelo campo de tag __tag__:__logstore__, indicando seu Logstore de origem. Por exemplo, o valor logstore-2 sinaliza que o log provém do Logstore-2.

Storeview for Metricstore

O StoreView for Metricstore possibilita consultas entre stores. Se esse tipo de StoreView estiver associado a metricstore1 e metricstore2, insira uma instrução PromQL na caixa de consulta. O backend consultará automaticamente todos os Metricstores associados. Para sintaxe de consulta, consulte Syntax for querying and analyzing metric data. Para criar ou modificar um StoreView for Metricstore, consulte Query data across Metricstores.

Na caixa de diálogo Create StoreView, insira um StoreView Name, como metric_storeview_test, selecione Time Series para StoreView Type, adicione os Metricstores desejados na área Associated Stores e clique em OK.

Análise

Conceito

A Data View permite agregação entre stores. Por exemplo, se um StoreView estiver associado ao LogStore-1 e ao LogStore-2, e ambos possuírem o campo a, a consulta * | select a, count(1) group by a retorna a contagem combinada do campo a em ambos os Logstores.

A agregação exige nomes de campos consistentes. Quando os nomes diferirem entre os stores, utilize a predefinição para renomeá-los. Consulte Predefinition capabilities.

Limitações

A análise de dados é compatível apenas com StoreView for Logstore, não se aplicando ao StoreView for Metricstore.

Funções suportadas

Para funções SQL e SPL, consulte Function overview.

Exemplos

Exemplo 1

Uma Log Data View está associada a Logstores do mesmo service com conteúdo de log idêntico. Garanta que as configurações de índice sejam idênticas nos Logstores (por exemplo, indexação de texto completo ativada ou índices de campo configurados da mesma maneira). Em seguida, adicione os Logstores à Log Data View.

Após criar uma Log Data View, utilize SQL para análise. Os resultados estatísticos para diferentes valores de status nos últimos 15 minutos representam a agregação de todos os logs dos dois Logstores.

A instrução de consulta é SELECT status, count(*) AS PV GROUP BY status. O resultado mostra PV=4 para status=200 e PV=8 para status=302.

Exemplo 2

Uma Log Data View está associada a Logstores do mesmo service cujos campos de log possuem nomes diferentes. Use uma instrução SPL predefinida para alinhar os nomes dos campos. Por exemplo, *|extend request_method = method renomeia o campo method para request_method. Clique em Preview data para verificar os resultados da predefinição.

Posteriormente, utilize request_method para analisar a consulta.

Execute a consulta * | SELECT request_method, count(*) GROUP BY request_method order by request_method desc no Storeview storeview_test. O gráfico exibe 4 requisições em que request_method é GET e 1 requisição em que request_method é nulo.

StoreView vs. Store

Operações relacionadas

• Query and analyze data across Logstores

• Query data across Metricstores