# Instalar o Collector no Linux

Site [llms.txt](/pt/llms.txt)

---

Cada versão do Collector inclui pacotes APK, DEB e RPM para sistemas Linux
amd64/arm64/i386. Após a instalação, a configuração padrão fica disponível em
`/etc/otelcol/config.yaml`.

> Observação: o `systemd` é necessário para a configuração automática do
> serviço.

## Instalação via DEB {#deb-installation}

Para começar em sistemas Debian, execute os seguintes comandos:

    <ul class="nav nav-tabs" id="tabs-0" role="tablist">
  <li class="nav-item">
      <button class="nav-link active"
          id="tabs-00-00-tab" data-bs-toggle="tab" data-bs-target="#tabs-00-00" role="tab"
          data-td-tp-persist="amd64" aria-controls="tabs-00-00" aria-selected="true">
        AMD64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-00-01-tab" data-bs-toggle="tab" data-bs-target="#tabs-00-01" role="tab"
          data-td-tp-persist="arm64" aria-controls="tabs-00-01" aria-selected="false">
        ARM64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-00-02-tab" data-bs-toggle="tab" data-bs-target="#tabs-00-02" role="tab"
          data-td-tp-persist="i386" aria-controls="tabs-00-02" aria-selected="false">
        i386
      </button>
    </li>
</ul>

<div class="tab-content" id="tabs-0-content">
    <div class="tab-body tab-pane fade show active"
        id="tabs-00-00" role="tabpanel" aria-labelled-by="tabs-00-00-tab" tabindex="0">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo apt-get update
</span></span><span class="line"><span class="cl">sudo apt-get -y install wget
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.147.0/otelcol_0.147.0_linux_amd64.deb
</span></span><span class="line"><span class="cl">sudo dpkg -i otelcol_0.147.0_linux_amd64.deb
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-00-01" role="tabpanel" aria-labelled-by="tabs-00-01-tab" tabindex="0">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo apt-get update
</span></span><span class="line"><span class="cl">sudo apt-get -y install wget
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.147.0/otelcol_0.147.0_linux_arm64.deb
</span></span><span class="line"><span class="cl">sudo dpkg -i otelcol_0.147.0_linux_arm64.deb
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-00-02" role="tabpanel" aria-labelled-by="tabs-00-02-tab" tabindex="0">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo apt-get update
</span></span><span class="line"><span class="cl">sudo apt-get -y install wget
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.147.0/otelcol_0.147.0_linux_386.deb
</span></span><span class="line"><span class="cl">sudo dpkg -i otelcol_0.147.0_linux_386.deb
</span></span></code></pre></div>
    </div>
</div>


## Instalação via RPM {#rpm-installation}

Para começar em sistemas Red Hat, execute os seguintes comandos:

    <ul class="nav nav-tabs" id="tabs-1" role="tablist">
  <li class="nav-item">
      <button class="nav-link active"
          id="tabs-01-00-tab" data-bs-toggle="tab" data-bs-target="#tabs-01-00" role="tab"
          data-td-tp-persist="amd64" aria-controls="tabs-01-00" aria-selected="true">
        AMD64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-01-01-tab" data-bs-toggle="tab" data-bs-target="#tabs-01-01" role="tab"
          data-td-tp-persist="arm64" aria-controls="tabs-01-01" aria-selected="false">
        ARM64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-01-02-tab" data-bs-toggle="tab" data-bs-target="#tabs-01-02" role="tab"
          data-td-tp-persist="i386" aria-controls="tabs-01-02" aria-selected="false">
        i386
      </button>
    </li>
</ul>

<div class="tab-content" id="tabs-1-content">
    <div class="tab-body tab-pane fade show active"
        id="tabs-01-00" role="tabpanel" aria-labelled-by="tabs-01-00-tab" tabindex="1">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo yum update
</span></span><span class="line"><span class="cl">sudo yum -y install wget systemctl
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.147.0/otelcol_0.147.0_linux_amd64.rpm
</span></span><span class="line"><span class="cl">sudo rpm -ivh otelcol_0.147.0_linux_amd64.rpm
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-01-01" role="tabpanel" aria-labelled-by="tabs-01-01-tab" tabindex="1">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo yum update
</span></span><span class="line"><span class="cl">sudo yum -y install wget systemctl
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.147.0/otelcol_0.147.0_linux_arm64.rpm
</span></span><span class="line"><span class="cl">sudo rpm -ivh otelcol_0.147.0_linux_arm64.rpm
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-01-02" role="tabpanel" aria-labelled-by="tabs-01-02-tab" tabindex="1">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo yum update
</span></span><span class="line"><span class="cl">sudo yum -y install wget systemctl
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.147.0/otelcol_0.147.0_linux_386.rpm
</span></span><span class="line"><span class="cl">sudo rpm -ivh otelcol_0.147.0_linux_386.rpm
</span></span></code></pre></div>
    </div>
</div>


## Instalação manual {#manual-installation}

As [versões][releases] para Linux estão disponíveis para diversas arquiteturas.
É possível baixar o arquivo binário e instalá-lo manualmente na sua máquina:

     <ul class="nav nav-tabs" id="tabs-2" role="tablist">
  <li class="nav-item">
      <button class="nav-link active"
          id="tabs-02-00-tab" data-bs-toggle="tab" data-bs-target="#tabs-02-00" role="tab"
          data-td-tp-persist="amd64" aria-controls="tabs-02-00" aria-selected="true">
        AMD64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-02-01-tab" data-bs-toggle="tab" data-bs-target="#tabs-02-01" role="tab"
          data-td-tp-persist="arm64" aria-controls="tabs-02-01" aria-selected="false">
        ARM64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-02-02-tab" data-bs-toggle="tab" data-bs-target="#tabs-02-02" role="tab"
          data-td-tp-persist="i386" aria-controls="tabs-02-02" aria-selected="false">
        i386
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-02-03-tab" data-bs-toggle="tab" data-bs-target="#tabs-02-03" role="tab"
          data-td-tp-persist="ppc64le" aria-controls="tabs-02-03" aria-selected="false">
        ppc64le
      </button>
    </li>
</ul>

<div class="tab-content" id="tabs-2-content">
    <div class="tab-body tab-pane fade show active"
        id="tabs-02-00" role="tabpanel" aria-labelled-by="tabs-02-00-tab" tabindex="2">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">curl --proto <span class="s1">&#39;=https&#39;</span> --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.147.0/otelcol_0.147.0_linux_amd64.tar.gz
</span></span><span class="line"><span class="cl">tar -xvf otelcol_0.147.0_linux_amd64.tar.gz
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-02-01" role="tabpanel" aria-labelled-by="tabs-02-01-tab" tabindex="2">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">curl --proto <span class="s1">&#39;=https&#39;</span> --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.147.0/otelcol_0.147.0_linux_arm64.tar.gz
</span></span><span class="line"><span class="cl">tar -xvf otelcol_0.147.0_linux_arm64.tar.gz
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-02-02" role="tabpanel" aria-labelled-by="tabs-02-02-tab" tabindex="2">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">curl --proto <span class="s1">&#39;=https&#39;</span> --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.147.0/otelcol_0.147.0_linux_386.tar.gz
</span></span><span class="line"><span class="cl">tar -xvf otelcol_0.147.0_linux_386.tar.gz
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-02-03" role="tabpanel" aria-labelled-by="tabs-02-03-tab" tabindex="2">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">curl --proto <span class="s1">&#39;=https&#39;</span> --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.147.0/otelcol_0.147.0_linux_ppc64le.tar.gz
</span></span><span class="line"><span class="cl">tar -xvf otelcol_0.147.0_linux_ppc64le.tar.gz
</span></span></code></pre></div>
    </div>
</div>


## Configuração automática do serviço {#automatic-service-configuration}

Quando o OpenTelemetry Collector é executado como um serviço do `systemd`, ele
inicia por padrão com o arquivo de configuração `/etc/otelcol/config.yaml`.

Caso queira alterar essa configuração, você pode editar a variável
`OTELCOL_OPTIONS` no arquivo de ambiente do `systemd`,
`/etc/otelcol/otelcol.conf`. Também é possível definir variáveis de ambiente
adicionais para o serviço `otelcol` no mesmo arquivo. Para obter a lista
completa de opções suportadas, execute o seguinte comando:

```sh
/usr/bin/otelcol --help
```

Se você modificar o arquivo de configuração do Collector (`config.yaml`) ou o
arquivo de ambiente (`otelcol.conf`), é necessário reiniciar o serviço para
aplicar as alterações:

```sh
sudo systemctl restart otelcol
```

Para verificar a saída de logs do serviço `otelcol`, execute:

```sh
sudo journalctl -u otelcol
```

[releases]:
  https://github.com/open-telemetry/opentelemetry-collector-releases/releases