<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Joao Marcos Santos on Medium]]></title>
        <description><![CDATA[Stories by Joao Marcos Santos on Medium]]></description>
        <link>https://medium.com/@joaomarcossantos?source=rss-161a05a7ac0a------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*2rDYK2F6a_NWs2co.</url>
            <title>Stories by Joao Marcos Santos on Medium</title>
            <link>https://medium.com/@joaomarcossantos?source=rss-161a05a7ac0a------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Thu, 19 Nov 2026 13:06:07 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@joaomarcossantos/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Home Lab — Parte 1: Monitorando a internet com Speedtest Tracker, Prometheus e Grafana]]></title>
            <link>https://medium.com/@joaomarcossantos/home-lab-parte-1-monitorando-a-internet-com-speedtest-tracker-prometheus-e-grafana-21c58534f11c?source=rss-161a05a7ac0a------2</link>
            <guid isPermaLink="false">https://medium.com/p/21c58534f11c</guid>
            <category><![CDATA[contêineres]]></category>
            <category><![CDATA[prometheus-monitoring]]></category>
            <category><![CDATA[homelab]]></category>
            <category><![CDATA[grafana]]></category>
            <category><![CDATA[observability]]></category>
            <dc:creator><![CDATA[Joao Marcos Santos]]></dc:creator>
            <pubDate>Fri, 24 Apr 2026 17:58:25 GMT</pubDate>
            <atom:updated>2026-04-24T17:58:25.984Z</atom:updated>
            <content:encoded><![CDATA[<p>Faz um tempo que eu queria montar um home lab de verdade. Não só rodar um container aqui, outro ali — mas construir um infra local que atenda as minhas necessidades.</p><p>Todo projeto precisa de um ponto de partida. O meu foi uma pergunta simples:</p><blockquote>“A minha internet está caindo e com problemas, ou é só o vídeo o youtube que tá lento para carregar?”</blockquote><p>Parece simples. Mas tem uma boa diferença entre abrir o Speedtest.net de vez em quando e ter um histórico real, contínuo, com gráficos de tendência mostrando o comportamento do link ao longo de dias e semanas. Foi aí que nasceu a primeira etapa do meu home lab.</p><h3>O problema com testes manuais</h3><p>Quando você roda um teste de velocidade manualmente, você captura um snapshot. Um momento. O que você não vê é: a degradação que acontece toda noite entre 20h e 22h. O jitter que sobe nos finais de semana. A queda que dura 3 minutos às 7h da manhã e ninguém percebe porque todo mundo ainda está dormindo.</p><p>Monitoramento contínuo e automatizado resolve exatamente isso. E a melhor parte: você tem os dados para embasar uma reclamação na Anatel se precisar.</p><h3>A stack escolhida</h3><p>Para essa primeira etapa, usei três ferramentas que se complementam muito bem:</p><p><strong>Speedtest Tracker</strong> — um serviço que roda testes de velocidade agendados usando o CLI da Ookla e armazena os resultados em SQLite. Tem uma interface web própria e expõe métricas no formato Prometheus.</p><p><strong>Prometheus</strong> — um banco de dados de séries temporais que coleta as métricas do Speedtest Tracker em intervalos regulares e as armazena com eficiência para consultas históricas.</p><p><strong>Grafana</strong> — a camada de visualização. Consome os dados do Prometheus e transforma em dashboards interativos com gráficos de linha, alertas e muito mais.</p><p>A arquitetura é simples:</p><pre>Internet → Speedtest Tracker → Prometheus → Grafana</pre><p>Cada ferramenta faz uma coisa bem feita. Essa separação de responsabilidades é o que torna o stack extensível — mais pra frente você pode adicionar outras fontes de dados ao Prometheus e visualizar tudo no mesmo Grafana.</p><h3>Por que Docker ?</h3><p>Poderia ter instalado tudo direto no host. Mas o Docker traz algumas vantagens que fazem diferença no dia a dia de um home lab:</p><p><strong>Simplicidade:</strong> Essa versão inicial pode rodar no seu notebook ou em uma máquina antiga</p><ul><li><strong>Simplicidade</strong>: Essa versão inicial pode rodar no seu notebook ou em uma máquina antiga.</li><li><strong>Isolamento</strong>: cada serviço tem seu próprio ambiente, sem conflito de dependências</li><li><strong>Reproducibilidade</strong>: o mesmo docker-compose.yml funciona em qualquer máquina Linux</li><li><strong>Facilidade de atualização</strong>: docker compose pull &amp;&amp; docker compose up -d e pronto</li><li><strong>Backups simples</strong>: os dados ficam em volumes mapeados para pastas locais</li></ul><p>Uma observação importante: como estou rodando no Linux com network_mode: host, o container usa diretamente a interface de rede da máquina, sem o overhead do NAT do Docker bridge. Isso garante que os testes de velocidade reflitam o link real.</p><h3>Estrutura do projeto</h3><pre>internet-monitor/<br>├── docker-compose.yml<br>├── .env<br>├── prometheus/<br>│   └── prometheus.yml<br>└── grafana/<br>    └── provisioning/<br>        └── datasources/<br>            └── prometheus.yml</pre><p>Tudo versionado e documentado.</p><h3>A configuração</h3><p>O ponto de atenção aqui foi a escolha de portas. Ferramentas de desenvolvimento web ocupam a faixa 3000–8999 (React na 3000, Vite na 5173, Django na 8000, Spring Boot na 8080). Para não ter conflito, escolhi portas fora dessa faixa:</p><pre><br>| Serviço            | Endereço                    |<br>| ------------------ | --------------------------- |<br>| Speedtest Tracker  | http://localhost:9100       |<br>| Prometheus         | http://localhost:9090       |<br>| Grafana            | http://localhost:9200       |</pre><p>O docker-compose.yml ficou assim:</p><pre>services:<br>  speedtest-tracker:<br>    image: lscr.io/linuxserver/speedtest-tracker:latest<br>    network_mode: host<br>    environment:<br>      - TZ=America/Sao_Paulo<br>      - APP_KEY=${APP_KEY}<br>      - APP_URL=http://localhost:9100<br>      - DB_CONNECTION=sqlite<br>      - SPEEDTEST_SCHEDULE=0 */3 * * *<br>      - PRUNE_RESULTS_OLDER_THAN=30<br>    volumes:<br>      - ./data/speedtest:/config<br><br>  prometheus:<br>    image: prom/prometheus:latest<br>    network_mode: host<br>    command:<br>      - &#39;--config.file=/etc/prometheus/prometheus.yml&#39;<br>      - &#39;--storage.tsdb.retention.time=90d&#39;<br>    volumes:<br>      - ./prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro<br>      - ./data/prometheus:/prometheus<br><br>  grafana:<br>    image: grafana/grafana:latest<br>    network_mode: host<br>    environment:<br>      - GF_SECURITY_ADMIN_USER=${GRAFANA_USER:-admin}<br>      - GF_SECURITY_ADMIN_PASSWORD=${GRAFANA_PASSWORD}<br>      - GF_SERVER_HTTP_PORT=9200<br>    volumes:<br>      - ./data/grafana:/var/lib/grafana<br>      - ./grafana/provisioning:/etc/grafana/provisioning</pre><p>O Prometheus configurado para fazer scrap do Speedtest Tracker a cada 5 minutos — frequência suficiente para capturar variações sem sobrecarregar a API:</p><pre>scrape_configs:<br>  - job_name: &#39;speedtest-tracker&#39;<br>    static_configs:<br>      - targets: [&#39;localhost:9100&#39;]<br>    metrics_path: &#39;/api/speedtest/metrics&#39;<br>    scrape_interval: 5m</pre><h3>Colocando no ar</h3><p>Com os arquivos prontos, subir o stack é um comando:</p><pre># Gerar a APP_KEY<br>echo &quot;APP_KEY=base64:$(openssl rand -base64 32)&quot; &gt; .env<br>echo &quot;GRAFANA_PASSWORD=minha-senha-forte&quot; &gt;&gt; .env<br><br># Subir tudo<br>docker compose up -d  </pre><p>Depois de alguns minutos os primeiros testes começam a aparecer. O Speedtest Tracker roda automaticamente no agendamento configurado — no meu caso, a cada 3 horas.</p><h3>O resultado</h3><p>Com o stack rodando, aqui está o que cada ferramenta mostra:</p><p><strong>Speedtest Tracker</strong> registrando cada teste com download, upload, ping e perda de pacotes — e conectando a diferentes servidores da Claro e NT Fibra no Rio de Janeiro:</p><figure><img alt="O resultado Com o stack rodando, aqui está o que cada ferramenta mostra: Speedtest Tracker registrando cada teste com download, upload, ping e perda de pacotes — e conectando a diferentes servidores da Claro e NT Fibra no Rio de Janeiro:" src="https://cdn-images-1.medium.com/max/1024/1*uGIucfeOYt_V2Q9I1vfxZg.png" /><figcaption>Tela de resultados do Speedtest Tracker: cada linha é um teste agendado, com servidor, download, upload, ping e packet loss.</figcaption></figure><blockquote>Uma coisa que chamou atenção: o teste de ID 7 apareceu como <em>Failed</em>. Isso é exatamente o tipo de dado que você não captura com testes manuais.</blockquote><p><strong>Prometheus</strong> confirmando que os dois targets estão UP e coletando métricas corretamente:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*JvrFqBRne6AFd-94_ijBzg.png" /><figcaption>Status dos targets no Prometheus: prometheus e speedtest-tracker ambos com estado UP.</figcaption></figure><p><strong>Grafana</strong> com o dashboard mostrando download, upload, jitter e ping ao longo do tempo — com gráficos de barras por servidor de teste:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bGOG5QiZEldrnjTQbkTlOQ.png" /><figcaption>Dashboard no Grafana: Download, Upload, Ping e Jitter ao longo do tempo, agrupados por servidor de teste.</figcaption></figure><h3>O que vem por aí</h3><p>Essa é só a Parte 1 de um home lab que pretendo expandir progressivamente. Nas próximas etapas, o plano é:</p><p><strong>Zabbix</strong> para monitoramento completo da rede interna — não só a velocidade do link externo, mas também: latência entre dispositivos, uso de banda por host, uptime de equipamentos, temperatura de servidores, espaço em disco. O Zabbix tem agentes que rodam nos dispositivos e um servidor central que consolida tudo, com um sistema de alertas muito mais sofisticado do que o Grafana nativo.</p><p><strong>Node Exporter</strong> em cada máquina do lab para expor métricas de sistema (CPU, memória, disco, rede) diretamente no Prometheus — mantendo o Grafana como painel unificado de visualização.</p><p><strong>Alertmanager</strong> integrado ao Prometheus para disparar notificações no Telegram quando a velocidade cair abaixo de um threshold ou quando um serviço ficar indisponível.</p><p>A ideia é que cada ferramenta adicionada conversa com as existentes, construindo uma infraestrutura de observabilidade progressiva — do link de internet até cada processo rodando nas máquinas.</p><p>Montar esse stack levou menos de uma tarde. O docker-compose.yml, os arquivos de configuração do Prometheus e o provisioning automático do datasource no Grafana — tudo junto são menos de 80 linhas de YAML.</p><p>O esforço é baixo. O retorno é alto. E é satisfatório abrir o Grafana de manhã e ver o histórico da noite anterior.</p><p>Para quem está pensando em começar um home lab: esse é um ponto de entrada excelente. Você aprende os fundamentos de observabilidade (coleta de métricas, séries temporais, visualização), trabalha com ferramentas usadas em ambientes de produção reais, e sai com algo útil no final.</p><p><em>Parte 2 em breve: configurando o Zabbix para monitoramento dos trafego dos dispositivos da rede local.</em></p><p><em>Todas as configurações desse projeto estão disponíveis no repositório no </em><a href="https://github.com/Joaomgsa/internet-monitor/"><em>GitHub</em></a><em>.</em></p><p><strong>Tags:</strong> homelab docker grafana prometheus devops networking selfhosted</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=21c58534f11c" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Como o CRUD acabou me frustrando.]]></title>
            <link>https://medium.com/@joaomarcossantos/como-o-crud-acabou-me-frustrando-efad3cf09834?source=rss-161a05a7ac0a------2</link>
            <guid isPermaLink="false">https://medium.com/p/efad3cf09834</guid>
            <category><![CDATA[spring]]></category>
            <category><![CDATA[crud]]></category>
            <category><![CDATA[dev]]></category>
            <dc:creator><![CDATA[Joao Marcos Santos]]></dc:creator>
            <pubDate>Fri, 23 Sep 2022 10:40:43 GMT</pubDate>
            <atom:updated>2022-09-23T10:40:43.838Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/979/1*it7Y_AXH28z4yxU7hrsKPg.jpeg" /></figure><p>Como iniciante o dev junior ,em especial em java, fica muito empolgado quando começa a evoluir dos programas iniciais do primeiro contato com a linguagem e dá aquele salto para um desenvolvedor WEB. Nossa agora eu uso o Spring e aprendi como funciona o modelo MVC. Consegui criar minha primeira API Rest.</p><p>Aí você naquele projeto de poucos minutos do youtube faz uma requisição get que lista todos os produtos, um post onde você coloca as informações no postman e aparece lá no banco de dados e faz aquele delete já té passando um parametro na uri.</p><p>Isso tudo é muito legal confortante e eu me enchi de confiança agora além de escrever API’s REST consigo fazer as requisições pelo Postman e vejo no mysql. Agora domino as ferramentas. A sensação de domínio das ferramentas e como um bom backend já faço tudo funcionar!</p><p>Bom aí eu descobri que não é bem assim rs.</p><p>Quando comecei a fazer alguns desafios técnicos ou pequenos projetos acabava empacando em tarefas simples tipo como arrumar uma requisição get e como serializar um json para enviar um post.</p><p>Mas onde faz isso? No meu crud funcionava tudo perfeitamente, aí eu descobri que precisava me aprofundar mais em arquitetura e estrutura de dados.</p><p>Repetir todos aqueles projetos foram um belo incentivo para começar e entender os conceitos gerais mas o desafio agora era outro.</p><p>Enfim esse artigo não é para desencorajar ninguém mas para documentar a minha jornada e seus desafios. Vou me esforçar para que a cada artigo eu relacione outros com as tecnologias/conceitos que usei em cada ponto.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=efad3cf09834" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>