Instalar o agente .NET no Azure Service Fabric

Este documento explica como instalar o agente .NET para Azure Service Fabric. Observação: isso não é o mesmo que instalar a integração de infraestrutura para Microsoft Azure.

Instalar o agente .NET no Azure Service Fabric

Se você estiver usando contêiner em seu ambiente do Service Fabric, consulte as instruções de instalação do Docker.

Você também pode instalar o agente em um ambiente do Service Fabric usando NuGet. O NuGet costuma ser uma boa opção para desenvolvedores porque o agente é implantado junto com seu aplicativo. Porém, o uso do NuGet requer alguns procedimentos de instalação manual. Consulte Instalar com NuGet.

Instalar usando NuGet

Para instalar o agente .NET usando NuGet:

1. Siga os procedimentos padrão de instalação do NuGet .

2. Ao usar o NuGet, você deve definir algumas variáveis de ambiente. Isso pode ser feito no arquivo ServiceManifest.xml do seu aplicativo. Veja as instruções relevantes abaixo:

   Framework .NET

   No arquivo ServiceManifest.xml do seu projeto, inclua o seguinte no nó CodePackage :

   <CodePackage Name="Code" Version="1.0.0">  </CodePackage>
   <CodePackage>
     ...
     <EntryPoint>
       <ExeHost>
         ...
         <!-- It is important for the WorkingFolder to be set to CodePackage -->
         <!-- This is because the environment variables set below rely on this being the working folder for the agent to work -->
         <WorkingFolder>CodePackage</WorkingFolder>
         ...
       </ExeHost>
     </EntryPoint>
     ...
     <EnvironmentVariables>
       ...
       <EnvironmentVariable Name="COR_ENABLE_PROFILING" Value="1" />
       <EnvironmentVariable Name="COR_PROFILER" Value="{71DA0A04-7777-4EC6-9643-7D28B46A8A41}" />
       <EnvironmentVariable Name="COR_PROFILER_PATH" Value=".\newrelic\NewRelic.Profiler.dll" />
       <EnvironmentVariable Name="NEWRELIC_HOME" Value=".\newrelic" />
       <EnvironmentVariable Name="NEW_RELIC_LICENSE_KEY" Value="YOUR_LICENSE_KEY" />
       <EnvironmentVariable Name="NEW_RELIC_APP_NAME" Value="YOUR_APP_NAME" />
       ...
     </EnvironmentVariables>
     ...
   </CodePackage>

   Copiar

   .NET Core para Windows

   No arquivo ServiceManifest.xml do seu projeto, inclua o seguinte no nó CodePackage :

   <CodePackage>
     ...
     <EntryPoint>
       <ExeHost>
         ...
         <!-- It is important for the WorkingFolder to be set to CodePackage -->
         <!-- This is because the environment variables set below rely on this being the working folder for the agent to work -->
         <WorkingFolder>CodePackage</WorkingFolder>
         ...
       </ExeHost>
     </EntryPoint>
     ...
     <EnvironmentVariables>
       ...
       <EnvironmentVariable Name="CORECLR_ENABLE_PROFILING" Value="1" />
       <EnvironmentVariable Name="CORECLR_PROFILER" Value="{36032161-FFC0-4B61-B559-F6C5D41BAE5A}" />
       <EnvironmentVariable Name="CORECLR_PROFILER_PATH" Value=".\newrelic\NewRelic.Profiler.dll" />
       <EnvironmentVariable Name="CORECLR_NEWRELIC_HOME" Value=".\newrelic" />
       <EnvironmentVariable Name="NEW_RELIC_LICENSE_KEY" Value="YOUR_LICENSE_KEY" />
       <EnvironmentVariable Name="NEW_RELIC_APP_NAME" Value="YOUR_APP_NAME" />
       ...
     </EnvironmentVariables>
     ...
   </CodePackage>

   Copiar

   .NET Core para Linux

   No arquivo ServiceManifest.xml do seu projeto, inclua o seguinte no nó CodePackage :

   <CodePackage>
     ...
     <EntryPoint>
       <ExeHost>
         ...
         <!-- It is important for the WorkingFolder to be set to CodePackage -->
         <!-- This is because the environment variables set below rely on this being the working folder for the agent to work -->
         <WorkingFolder>CodePackage</WorkingFolder>
         ...
       </ExeHost>
     </EntryPoint>
     ...
     <EnvironmentVariables>
       ...
       <EnvironmentVariable Name="CORECLR_ENABLE_PROFILING" Value="1" />
       <EnvironmentVariable Name="CORECLR_PROFILER" Value="{36032161-FFC0-4B61-B559-F6C5D41BAE5A}" />
       <EnvironmentVariable Name="CORECLR_PROFILER_PATH" Value="./newrelic/libNewRelicProfiler.so" />
       <EnvironmentVariable Name="CORECLR_NEWRELIC_HOME" Value="./newrelic" />
       <EnvironmentVariable Name="NEW_RELIC_LICENSE_KEY" Value="YOUR_LICENSE_KEY" />
       <EnvironmentVariable Name="NEW_RELIC_APP_NAME" Value="YOUR_APP_NAME" />
       ...
     </EnvironmentVariables>
     ...
   </CodePackage>

   Copiar

3. For the .NET Framework only: edite seu arquivo app.config e adicione a configuração do aplicativo NewRelic.AgentEnabled :

   <appSettings>
     ...
     <add key="NewRelic.AgentEnabled" value="true" />
     ...
   </appSettings>

   Copiar

Se seu aplicativo estiver gerando tráfego, os dados deverão aparecer em sua conta APM em alguns minutos.

Se os dados não aparecerem, tente estas etapas de resolução de problemas:

• Certifique-se de que todos os arquivos no diretório newrelic na raiz do seu aplicativo foram publicados no Azure.
• Certifique-se de que as variáveis de ambiente estejam definidas corretamente.
• Consulte a documentação geral sobre resolução de problemas para verificar erros comuns.