Conector Linear: integração com BigQuery, Redshift, ClickHouse e mais sem pipeline manual
Conector gerenciado para sincronizar issues, cycles e projetos do Linear para BigQuery, Redshift e mais. Incremental, sem código.
Times de engenharia vivem no Linear. Issues criadas, ciclos fechados, projetos entregues, e dentro de toda essa atividade existe um volume enorme de dados sobre como o seu time realmente funciona: tempo de ciclo, saúde do backlog, throughput, taxa de resolução. O problema é que esses dados sempre ficaram presos dentro do Linear, desconectados do restante da sua stack analítica.
A API do Linear é bem documentada e usa GraphQL, o que faz parecer simples puxar issues e cycles direto pro warehouse com uma query customizada. Na prática, isso vira um script que alguém precisa manter para sempre, lidando com paginação por cursor, limites de complexidade de query da API GraphQL, e schema que evolui conforme o Linear adiciona campos novos aos objetos. O conector da Erathos entrega essa integração como serviço gerenciado, sem exigir que o time escreva ou mantenha esse código.
O problema com pipelines de Linear feitos na mão
A maioria das ferramentas de ingestão trata conector como caixa-preta: você aponta pra uma API, os dados são puxados, e você torce pra que funcione. Quando algo quebra, você descobre semanas depois, no downstream, num dashboard quebrado.
Paginação por cursor e limite de complexidade de query
A API GraphQL do Linear pagina por cursor e limita a complexidade de cada query. Uma extração ingênua que tenta puxar issues com todos os campos relacionados (labels, comentários, histórico de estado) numa query só esbarra nesse limite, e a lógica de quebrar isso em queries menores precisa ser escrita e mantida.
Schema evolution sem aviso
O Linear adiciona campos novos a objetos como issues e cycles com alguma frequência. Sem uma estratégia de schema evolution automática, cada mudança dessas exige alteração manual no pipeline antes que o dado novo comece a chegar.
Rotação de token esquecida
A autenticação do Linear é feita via Personal API Key, gerada dentro do workspace. Um script simples costuma guardar esse token direto no código ou numa variável de ambiente sem processo de rotação, e quando alguém revoga a chave por engano (ou ela é regenerada por segurança), o pipeline para silenciosamente até alguém notar a falta de dado novo.
Observabilidade que não existe
Sem contagem de registros por execução, sem comparação com a janela anterior, sem alerta de queda de volume, você está voando cego. O pipeline que rodou com sucesso pode ter trazido zero issues novas porque o cursor ficou preso.
O que você pode ingerir
O conector Linear entrega oito endpoints prontos para serem materializados no seu warehouse de destino:
Endpoint | O que contém |
|---|---|
| Issues com estados, prioridades, labels, responsáveis e tempos de ciclo |
| Times, estrutura organizacional e configurações |
| Usuários, para análise de atribuição e carga de trabalho |
| Projetos vinculados a times, milestones e atualizações de status |
| Estados de workflow, para rastreamento de conformidade de processo |
| Dados de sprint, incluindo escopo, velocidade e taxas de conclusão |
| Labels aplicadas a issues |
| Comentários, para análise de padrões de comunicação |
Os destinos suportados são BigQuery, Redshift, Databricks, ClickHouse, PostgreSQL, Supabase, Azure Synapse e Amazon S3.
O que você pode fazer quando os dados do Linear chegam no warehouse
Analytics de performance de engenharia. Combine dados de ciclos do Linear com seus logs de deploy para construir métricas DORA reais, com contexto. É o mesmo tipo de análise que já detalhamos no post do conector GitHub, e que fica ainda mais completa quando você cruza dado de planejamento (Linear) com dado de execução (GitHub).
Monitoramento de saúde do backlog. Acompanhe aging de issues, latência de triagem e distribuição de labels ao longo do tempo no seu warehouse, com granularidade que nenhum relatório nativo do Linear entrega.
Relatórios cross-funcionais. Cruze dados de projetos do Linear com seu CRM, tickets de suporte ou dados de uso do produto para entender como o esforço de engenharia se traduz em resultado para o cliente.
Retrospectivas de sprint orientadas a dados. Pare de reconstruir o que aconteceu de memória. Consulte o histórico de ciclos diretamente, organizado em camadas de qualidade progressiva como propõe a Arquitetura Medalhão.
Por que terceirizar a ingestão para a Erathos
A premissa do conector é direta: a engenharia de manutenção da ingestão não deveria ser responsabilidade do seu time de dados. Paginação, limite de complexidade de query, renovação de OAuth, schema evolution, alerta de falha, alerta de queda de volume, backfill. Tudo isso é responsabilidade de quem opera a plataforma de ingestão.
Com o conector configurado, a plataforma entrega:
Visibilidade ponta a ponta de cada execução. Você vê exatamente quais registros foram buscados, quais foram ignorados, e por quê. Quando uma métrica muda no dashboard, você tem a trilha completa para encontrar a causa raiz.
Controle total sem código. Você controla a frequência de sync, o cursor incremental e como mudanças de schema são tratadas, sem precisar mexer em nenhuma linha de código de infraestrutura.
Reprocessamento como operação suportada. Quando você precisa reprocessar uma janela, seja porque mudou a lógica do modelo ou porque recebeu uma correção da fonte, isso é uma operação de plataforma, não um script improvisado.
A Brick, insurtech de Curitiba que centralizou a ingestão de dados com a Erathos, tem o Linear como uma das fontes conectadas na stack dela hoje, ao lado de HubSpot, Conta Azul e GitHub, tudo mantido por um único analista de dados, sem time de engenharia dedicado a pipeline.
Como autenticar
A autenticação do conector requer um campo:
- Token: sua Personal API Key do Linear
Para gerar o token, navegue dentro do Linear em Settings > API > Personal API keys, clique em Create key, dê um nome a ela, e copie o valor gerado. Cole no campo Token da Erathos.
O processo completo está documentado em docs.erathos.com/connectors/apis/linear. Uma vez conectado, você escolhe quais times e tipos de objetos sincronizar, define o schema de destino, e a Erathos cuida do resto.
Perguntas frequentes sobre o conector do Linear
O conector do Linear usa API key ou OAuth? Personal API Key. Você gera o token em Settings > API > Personal API keys dentro do seu workspace do Linear, e cola no campo Token da Erathos ao configurar a conexão.
O conector sincroniza mais de um time do Linear? Sim. Depois de conectado, você escolhe quais times e quais tipos de objetos (issues, cycles, projetos, etc.) sincronizar, sem precisar configurar uma conexão separada por time.
O conector suporta sincronização incremental? Sim, todos os objetos, incluindo issues, cycles e comentários, são sincronizados de forma incremental após a carga inicial.
O limite de complexidade de query da API GraphQL do Linear afeta a sincronização? Não do seu lado. O conector já lida com isso, quebrando as extrações em queries dentro do limite de complexidade permitido pela API.
Para quais destinos o conector do Linear sincroniza dados? BigQuery, Redshift, Databricks, ClickHouse, PostgreSQL, Supabase, Azure Synapse e Amazon S3.
Pipelines disponíveis
O conector do Linear está disponível com os seguintes destinos:
- Linear → BigQuery
- Linear → Redshift
- Linear → Databricks
- Linear → ClickHouse
- Linear → PostgreSQL
- Linear → Supabase
- Linear → Azure Synapse
- Linear → Amazon S3
Comece agora
O conector Linear está disponível para todos os usuários da Erathos. Crie sua conta na Erathos e conecte seu workspace em minutos, sem código de pipeline para escrever, manter ou monitorar.