Managed Service for OpenTelemetry:Use Jaeger to report C++ application data

Novo console

1. Faça login no console do Managed Service for OpenTelemetry.

2. No painel de navegação à esquerda, clique em Integration Center.

3. Na página Integration Center, na seção Open Source Frameworks, clique no cartão Jaeger.

4. No painel Jaeger, clique na aba Start Integration e selecione a região onde deseja relatar os dados.

   Nota

   Ao acessar uma região pela primeira vez, os recursos são inicializados automaticamente.

5. Defina Connection Type e Export Protocol e copie o endpoint.

   Parâmetro	Orientação
   Connection Type	Se seu service executa na Alibaba Cloud na região selecionada, selecione Alibaba Cloud VPC Network. Caso contrário, selecione Public Network.
   Export Protocol	Selecione HTTP (recomendado) ou gRPC, dependendo do protocolo suportado pelo seu cliente.

   

Console antigo

1. Faça login no console do Managed Service for OpenTelemetry.

2. No painel de navegação à esquerda, clique em Cluster Configurations. Na página exibida, clique na aba Access point information.

3. Na barra de navegação superior, selecione a região onde deseja relatar os dados. Na seção Cluster Information, ative Show Token.

4. Defina Client como Jaeger. Na coluna Related Information, copie um endpoint.

   Nota

   Se sua aplicação executa em um ambiente de produção da Alibaba Cloud, use um endpoint de VPC. Caso contrário, utilize um endpoint público.

   

Etapa 1: Baixar e compilar o jaeger-client-cpp

1. Baixe e extraia o código-fonte:

   wget https://github.com/jaegertracing/jaeger-client-cpp/archive/master.zip && unzip master.zip

2. Extraia o pacote e entre no diretório. Em seguida, compile o projeto:

   Nota

   A compilação requer CMake e GCC 4.9.2 ou superior.

   mkdir build
   cd build
   cmake ..
   make

Etapa 2: Iniciar o Jaeger Agent

Baixe o Jaeger Agent e inicie-o com seu endpoint:

nohup ./jaeger-agent --reporter.grpc.host-port=tracing-analysis-dc-sz.aliyuncs.com:1883 --jaeger.tags=<endpoint>

Substitua o seguinte espaço reservado pelo valor real:

Etapa 3: Executar o exemplo

No diretório build, execute o exemplo incluído:

./app ../examples/config.yml

Quando reporter.logSpans está definido como true no arquivo de configuração, a aplicação registra cada span no console.

Etapa 4: Verificar rastreamentos

Abra o console do Managed Service for OpenTelemetry e acesse a página Applications. Clique no nome da aplicação para visualizar seus dados de rastreamento, incluindo topologia, rastreamentos e análise de transações. Se os rastreamentos não aparecerem em alguns minutos, verifique se o Jaeger Agent foi iniciado sem erros e se o endpoint está correto.

Criar um Tracer

Um Tracer gera spans que representam unidades de trabalho. Inicialize-o a partir de um arquivo de configuração YAML e registre-o como o tracer global:

#include <jaegertracing/Tracer.h>
#include <yaml-cpp/yaml.h>

void setUpTracer(const char* configFilePath)
{
    auto configYAML = YAML::LoadFile(configFilePath);

    // Parse the Jaeger configuration from the YAML file.
    auto config = jaegertracing::Config::parse(configYAML);

    // Create a tracer with a service name and console logger.
    auto tracer = jaegertracing::Tracer::make(
        "example-service", config, jaegertracing::logging::consoleLogger());

    // Register the tracer as a global instance.
    opentracing::Tracer::InitGlobal(
        std::static_pointer_cast<opentracing::Tracer>(tracer));
}

Utilize a seguinte configuração YAML:

disabled: false
reporter:
  logSpans: true
sampler:
  type: const
  param: 1

Criar spans

Spans representam operações individuais dentro de um rastreamento. Crie spans raiz para operações de nível superior e spans filhos para suboperações:

#include <opentracing/tracer.h>

// Create a child span under an existing parent span.
void tracedSubroutine(const std::unique_ptr<opentracing::Span>& parentSpan)
{
    auto span = opentracing::Tracer::Global()->StartSpan(
        "tracedSubroutine",
        { opentracing::ChildOf(&parentSpan->context()) });
}

// Create a root span (no parent).
void tracedFunction()
{
    auto span = opentracing::Tracer::Global()->StartSpan("tracedFunction");
    tracedSubroutine(span);
}

Depois que o Jaeger Agent estiver em execução (consulte Etapa 2: Iniciar o Jaeger Agent), os spans são relatados automaticamente ao Managed Service for OpenTelemetry.