> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tutoriais

> Tutoriais de Ruby e Rails sobre instalar o AppSignal, Solid Queue, background jobs, debugging, strong parameters, autenticação e recursos recentes do Rails.

Estes tutoriais foram originalmente produzidos pela [GoRails](https://gorails.com/), com conteúdo novo escrito especificamente para clientes do AppSignal.

Assista aos vídeos, leia os passo a passo escritos, ou entregue estas páginas ao seu agente.

Os [guias](/guides) explicam como usar o AppSignal. Para uma aplicação Rails, comece por [AppSignal para Ruby](/ruby) e sua [integração com o Rails](/ruby/integrations/rails). Estes tutoriais explicam as ferramentas de Ruby e Rails que produzem os dados que o AppSignal monitora.

<h2 id="meet-chris-oliver">
  Conheça Chris Oliver
</h2>

A GoRails é a biblioteca de conteúdo que Chris Oliver vem publicando desde 2014.

<Frame caption="Chris Oliver, fundador da GoRails">
  <img src="https://mintcdn.com/appsignal-715f5a51/7bmJ0R9GDWouayDR/assets/images/tutorials/chris-oliver.jpg?fit=max&auto=format&n=7bmJ0R9GDWouayDR&q=85&s=d33a5f49918a508d9fa87bcce7775e5e" alt="Retrato de Chris Oliver" width="400" height="400" data-path="assets/images/tutorials/chris-oliver.jpg" />
</Frame>

Além da GoRails, Chris constrói o [Jumpstart Pro](https://jumpstartrails.com), um template de SaaS em Rails, e o [Hatchbox](https://hatchbox.io), uma plataforma de deploy. O Hatchbox já rodou mais de dois milhões de deploys desde 2016. Ele também co-apresenta o podcast Remote Ruby.

Seu trabalho open source está na árvore de dependências de muitas aplicações Rails. O [`noticed`](https://github.com/excid3/noticed) cuida de notificações, o [`madmin`](https://github.com/excid3/madmin) de interfaces administrativas, e o [`receipts`](https://github.com/excid3/receipts) de faturamento, entre [o restante dos seus repositórios](https://github.com/excid3).

Essa combinação é o que torna o material aqui digno de ser republicado. As lições vêm de alguém que roda aplicações Rails em produção, encontra o problema em primeira mão, e então o explica.

<h2 id="appsignal-expert-context-store">
  AppSignal Expert Context Store
</h2>

O AppSignal oferece recursos de Intelligence baseados em um context store de pelo menos quatro fontes de sinal.

| Fonte | O que ela contribui |
| - | - |
| Sua telemetria | [Métricas](/metrics/dashboards), [logs](/logging) e [traces](/performance-tracing) das suas aplicações e dos serviços que elas chamam, [métricas de host e infraestrutura](/metrics/host-metrics), e [como os usuários finais vivenciam tudo isso](/browser-monitoring). O que está acontecendo na sua stack, agora. |
| Nossa documentação | Referência validada do AppSignal e boas práticas. |
| Conhecimento especializado | Como esses frameworks de aplicação e serviço funcionam, de profissionais com experiência reconhecida, apresentado em tutoriais como estes. |
| A base de conhecimento da sua organização | Seu inventário de aplicações e infraestrutura, e a [ownership](/ruby/integrations/ownership) e a [estrutura de equipe](/organization/team/teams) mapeadas sobre ele. Notas do [Logbook](/anomaly-detection) sobre incidents, e os tickets do [Jira](/application/integrations/jira), [GitHub](/application/integrations/github) e [Linear](/application/integrations/linear) em que se transformam. Quem é dono do quê, e o que já foi decidido sobre isso. |

<h3 id="the-intelligence-features">
  Os recursos de Intelligence
</h3>

* **[Intelligence dashboards](/metrics/intelligence-dashboards).** Os dashboards se constroem sozinhos a partir das integrações que o AppSignal detecta. Uma nova instalação do Sidekiq ou do Active Job já chega com os gráficos que importam prontos.
* **[Time Detective](/trace-page).** Reconstrói como sua aplicação estava no momento de um trace. Você pode ler uma requisição lenta à luz do estado em que ela rodou.
* **[AppSignal MCP](/mcp-server) e a [CLI](/cli).** Coloque um agente na frente de tudo isso, no seu editor ou terminal. Você pode então fazer perguntas sobre os seus próprios dados com as suas próprias palavras.

A premissa é a mesma em todos eles: o AppSignal enriquece e interpreta sua telemetria, em vez de apenas armazená-la.

<h3 id="these-tutorials-as-expert-context">
  Estes tutoriais como contexto especializado
</h3>

O conhecimento especializado é o único sinal que o AppSignal não consegue produzir sozinho. A documentação e a telemetria são nossas para escrever, e a base de conhecimento da sua organização cresce conforme sua equipe trabalha.

O conhecimento especializado, não. Instrumentar um framework não ensina como o Solid Queue se comporta sob carga. Também não diz qual dos dois, `step` ou `next`, você quer usar em um breakpoint. Vem de pessoas que rodaram essas ferramentas em produção e passaram anos explicando-as a outros desenvolvedores. Trazer isso para um context store significa trabalhar com elas.

Por isso, estes tutoriais são feitos com a GoRails. O que está documentado aqui é o que Chris e sua equipe ensinam. É publicado nas mesmas URLs, no mesmo corpus, junto com tudo o mais que os recursos de Intelligence do AppSignal leem.

Uma única página atende os dois públicos:

* **Pessoas.** Um vídeo, seguido de um passo a passo escrito com os comandos e o código em ordem.
* **Agentes.** Cada página também é servida como Markdown puro na sua própria URL, com a extensão `.md`, e está listada em [`llms.txt`](https://docs.appsignal.com/llms.txt). Os próprios agentes de Intelligence do AppSignal a leem, assim como qualquer agente que você mesmo construir e apontar para esta documentação.

<h2 id="the-tutorials">
  Os tutoriais
</h2>

<CardGroup cols={2}>
  <Card title="Instalar o AppSignal" icon="signal" href="/tutorials/ruby/install-appsignal">
    Instale o AppSignal no Rails e inspecione dados de uma aplicação implantada.
  </Card>

  <Card title="Solid Queue" icon="database" href="/tutorials/ruby/solid-queue">
    Rode o Active Job no seu banco de dados existente, sem Redis.
  </Card>

  <Card title="Mission Control Jobs" icon="table-list" href="/tutorials/ruby/mission-control-jobs">
    Monte um dashboard de jobs dentro da sua própria aplicação.
  </Card>

  <Card title="Agrupando background jobs" icon="layer-group" href="/tutorials/ruby/batching-background-jobs">
    Execute jobs em paralelo e reaja quando todos tiverem terminado.
  </Card>

  <Card title="Debugging com a gem debug" icon="bug" href="/tutorials/ruby/debugging-with-the-debug-gem">
    Breakpoints, execução passo a passo e navegação pela stack a partir do console.
  </Card>

  <Card title="Params expect" icon="shield-check" href="/tutorials/ruby/params-expect">
    Permita e exija parâmetros em uma única etapa com o Rails 8.
  </Card>

  <Card title="Parâmetros com valores padrão" icon="sliders" href="/tutorials/ruby/parameters-with-defaults">
    Forneça valores padrão para parâmetros que o navegador pode omitir.
  </Card>

  <Card title="Impersonation" icon="user-secret" href="/tutorials/ruby/impersonation">
    Adicione impersonation de usuário ao gerador de autenticação do Rails 8.
  </Card>

  <Card title="CI local" icon="terminal" href="/tutorials/ruby/local-ci">
    Rode sua suíte de CI localmente e aprove pull requests no GitHub.
  </Card>

  <Card title="Renderizador de Markdown" icon="file-lines" href="/tutorials/ruby/markdown-renderer">
    Responda com `text/markdown` usando o tipo MIME do Rails 8.1.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.