Skip to content

wizsolucoes/ng-application-insights

Repository files navigation

Wiz NgApplicationInsights

Adicione o Microsoft Application Insights à sua aplicação com apenas um comando.

Sobre

Este schematic irá instalar o pacote @wizsolucoes/ng-application-insights, bem como suas dependências de pares e modificar o arquivo app.module.ts para usar o pacote.

Uso

Basta executar o schematic na raiz do seu projeto Angular:

ng add @wizsolucoes/ng-application-insights

Configuração

Após a finalização da execução do schematic, deve-se customizar o objeto de configuração no módulo que foi importado pelo schematic em app.module.ts. Exemplo:

@NgModule({
  // ...
  imports: [
    NgApplicationInsightsModule.forRoot({
      // Booleano para hablitar Application Insights.
      // Típicamente "false" em ambientes de desenvolvimento e "true" em ambientes de produção.
      // Sugestão: environment.production
      enabled: environment.production,

      // String que corresponda à chave de instrumentação da Application Insights.
      instrumentationKey: 'sua-chave-aqui',

      // Objeto de custom properties para o AppInsights. A propriedade é opcional.
      properties: {
        'Some property': 'value', // Qualquer tipo de valor é aceito
        ...
      }
    }),
  ],

Além de poder passar as propriedades customizadas no momento da instância, o usuário também pode acrescentar novas propriedades utilizando a função 'setCustomProperties':

// Tenant ID é configurado para utilização do AppInsights
this.appInsightsService.setCustomProperties({
  'New Property': 'value', // Qualquer tipo de valor é aceito
});

Desenvolvimento, por onde começar

# Instalar dependências
npm install

cd projects/ng-application-insights

npm install

cd schematics

npm install

cd ../../../

# Build Lib   Schematics
npm run build

# Executar os testes
npm test

Testando Lib Schematics localmente

  1. Gere um distribuível da lib e do schematics
# Instalar dependências
npm install

cd projects/ng-application-insights

npm install

cd schematics

npm install

cd ../../../

# Build Lib   Schematics
npm run build

# Gerar tarball e.g. wizsolucoes-ng-application-insights-1.0.0.tgz
cd dist/ng-application-insights

npm pack
  1. Instale e execute o schematic na raiz de qualquer aplicação
# Instalar lib   schematics
npm i --no-save ../path/to/ng-application-insights/wizsolucoes-ng-application-insights-x.x.x.tgz # substitue x.x.x é a versão em projects/ng-application-insights/package.json

# Executar o schematic
ng g @wizsolucoes/ng-application-insights:ng-add