# Registro de logs

{% hint style="info" %}
Aplicável à versão 2.4 e superior
{% endhint %}

## AppConfig:LoggingConfig:WorkspaceId

*Linux: AppConfig\_\_LoggingConfig\_\_WorkspaceId*

**Valor:** Guid

**Descrição:**

O WorkspaceID do seu Log Analytics Workspace (mostrado na Overview do workspace). Esta é uma configuração obrigatória se quiser usar o Azure Monitor juntamente com [SharedKey](#appconfig-loggingconfig-sharedkey).

{% hint style="warning" %}
Este método de registo está descontinuado e a Microsoft anunciou que vai desativar esta API de registo. Mude para AppConfig:LoggingConfig:DataCollectionEndpointUri e AppConfig:LoggingConfig:RuleId em vez disso, conforme descrito no [Gestão de Registos](https://docs.scepman.com/pt/configuracao-do-azure/log-configuration) artigo.
{% endhint %}

## AppConfig:LoggingConfig:SharedKey

*Linux: AppConfig\_\_LoggingConfig\_\_SharedKey*

**Valor:** String

**Descrição:**

Use uma das duas chaves do Log Analytics Workspace. Elas são apresentadas se aceder ao Log Analytics Workspace em portal.azure.com e navegar para Settings/Agents, onde pode expandir a secção "Log Analytics agent instructions". Use a chave Primary ou Secondary.

Esta é uma configuração obrigatória se quiser usar o Azure Monitor, juntamente com WorkspaceId.

{% hint style="warning" %}
Este método de registo está descontinuado e a Microsoft anunciou que vai desativar esta API de registo. Mude para AppConfig:LoggingConfig:DataCollectionEndpointUri e AppConfig:LoggingConfig:RuleId em vez disso, conforme descrito no [Gestão de Registos](https://docs.scepman.com/pt/configuracao-do-azure/log-configuration) artigo.
{% endhint %}

{% hint style="info" %}
O SCEPman Certificate Master não suporta armazenar valores de configuração no Key Vault da mesma forma que o componente principal do SCEPman suporta. No entanto, existe uma forma genérica de armazenar definições do App Service no Key Vault, que [Mika Berglund](https://mikaberglund.com/store-your-app-service-configuration-settings-in-azure-key-vault/) descreve no seu blogue. Em resumo, tem de adicionar a permissão Secrets-Get à Managed Identity do Certificate Master e, para o SharedKey, deverá usar `@Microsoft.KeyVault(SecretUri=https://YOURKEYVAULTNAMEHERE.vault.azure.net/secrets/appconfig--loggingconfig--sharedkey/)` como valor para AppConfig:LoggingConfig:SharedKey.
{% endhint %}

## AppConfig:LoggingConfig:DataCollectionEndpointUri

*Linux: AppConfig\_\_LoggingConfig\_\_DataCollectionEndpointUri*

**Valor:** String

**Descrição:**

Usado em conjunto com AppConfig:LoggingConfig:RuleId para registar num Log Analytics Workspace, autenticando com a Managed Identity do App Service.

Este é o URI do Data Collection Endpoint (DCE) do Azure Monitor.

## AppConfig:LoggingConfig:RuleId

*Linux: AppConfig\_\_LoggingConfig\_\_RuleId*

**Valor**: String

**Descrição:**

Usado em conjunto com AppConfig:LoggingConfig:DataCollectionEndpointUri para registar num Log Analytics Workspace, autenticando com a Managed Identity do App Service.

Esta definição é o Id imutável do recurso Data Collection Rule (DCR).

As Managed Identities dos App Services que registam no DCR precisam de receber a função *Monitoring Metrics Publisher* no DCR.

Normalmente, não configura esta definição manualmente, pois o módulo SCEPman PS ou o módulo Terraform fazem isso por si e também atribuem automaticamente a função necessária quando criam o DCR e o DCE.

## AppConfig:LoggingConfig:AzureOfferingDomain

*Linux: AppConfig\_\_LoggingConfig\_\_AzureOfferingDomain*

**Valor:** String

**Descrição:**

Se o workspace não estiver na Global Azure Cloud, pode configurar aqui o domínio da oferta. O valor predefinido é 'azure.com'.

{% hint style="danger" %}
As alterações podem comprometer o seu serviço!
{% endhint %}

## AppConfig:LoggingConfig:LogLevel

*Linux: AppConfig\_\_LoggingConfig\_\_LogLevel*

**Valor:** Trace, Debug, Info, Warn, Error, Fatal

**Descrição:**

O nível mínimo de log a registar. O valor predefinido é 'Info'. Apenas entradas de log com um nível igual ou superior ao nível configurado serão registadas.

Note que, se configurar esta definição para 'Trace' ou 'Debug', o output do log pode conter dados pessoais, como UPNs ou endereços IP dos utilizadores. Se quiser evitar dados pessoais no output do log, deve configurar esta definição para 'Info' ou superior.

## AppConfig:LoggingConfig:AzureEventHubConnectionString

*Linux: AppConfig\_\_LoggingConfig\_\_AzureEventHubConnectionString*

{% hint style="info" %}
É possível registar no Azure Event Hub na versão 2.7 e superior
{% endhint %}

**Valor:** String

**Descrição:**

A connection string do seu Azure Event Hub. Esta é uma configuração obrigatória se quiser usar o Azure Event Hub.

## AppConfig:LoggingConfig:AzureEventHubName

*Linux: AppConfig\_\_LoggingConfig\_\_AzureEventHubName*

{% hint style="info" %}
É possível registar no Azure Event Hub na versão 2.7 e superior
{% endhint %}

**Valor:** String

**Descrição:**

O nome do seu Azure Event Hub. Esta é uma configuração obrigatória se quiser usar o Azure Event Hub.

## AppConfig:LoggingConfig:AzureEventHubPartitionKey

*Linux: AppConfig\_\_LoggingConfig\_\_AzureEventHubPartitionKey*

{% hint style="info" %}
É possível registar no Azure Event Hub na versão 2.7 e superior
{% endhint %}

**Valor:** String

**Descrição:**

A partition key do seu Azure Event Hub. A configuração desta opção é opcional. Se não a definir, o valor predefinido será '0'.