Manutenção

A página de Manutenção oferece diversas ferramentas para garantir que seu CDN funcione de forma eficiente, resolver problemas comuns e manter a sincronização entre seu WordPress e o Cloudflare R2. Essas ferramentas são essenciais para o gerenciamento a longo prazo do seu CDN e ajudam a identificar e corrigir inconsistências.

Visão Geral

Com o tempo, inconsistências podem surgir entre os registros locais do WordPress e os arquivos armazenados no Cloudflare R2. Isso pode acontecer por diversos motivos:

• Falhas durante o upload ou exclusão de arquivos
• Problemas de conectividade temporários
• Modificações manuais no bucket R2
• Exclusão de posts ou imagens no WordPress sem atualizar o R2
• Incompatibilidades com outros plugins
• Migração de servidor ou restauração de backup

As ferramentas de manutenção ajudam a identificar e corrigir esses problemas, garantindo que seu CDN continue funcionando perfeitamente.

Ferramentas de Manutenção

A página de Manutenção inclui diversas ferramentas organizadas em categorias:

Diagnóstico e Estatísticas

• Verificar Status do Sistema: Executa um diagnóstico completo do plugin e sua conexão com o R2.
• Recalcular Estatísticas: Atualiza as estatísticas de arquivos enviados para o R2, garantindo que os números exibidos no painel sejam precisos.
• Analisar Banco de Dados: Examina as tabelas do banco de dados do plugin para garantir sua integridade.
• Verificar Requisitos: Confirma se seu servidor ainda atende a todos os requisitos para o funcionamento adequado do plugin.

Ferramentas de Cache

• Limpar Cache do Plugin: Remove dados de cache temporários do plugin para resolver problemas de desempenho ou display.
• Reconstruir Cache de URLs: Regenera o cache de URLs para garantir que todas as URLs apontem corretamente para o CDN.
• Invalidar Cache do CDN: Envia solicitações de invalidação de cache para o Cloudflare, forçando a atualização de arquivos no CDN.

Ferramentas de Consistência

• Verificar Consistência: Compara os registros locais com os arquivos reais no R2 para identificar discrepâncias.
• Sincronizar Registros: Atualiza os registros locais para corresponder aos arquivos existentes no R2.
• Marcar Tudo como Enviado: Marca todas as imagens como enviadas para resolver problemas de status (use com cuidado).
• Limpar Registros Órfãos: Remove registros de arquivos que não existem mais na biblioteca de mídia ou no R2.

Ferramentas de Recuperação

• Reparar Metadados: Corrige metadados de imagens que podem ter sido corrompidos durante o processo de upload ou otimização.
• Restaurar Configurações Padrão: Redefine as configurações do plugin para os valores padrão (não afeta arquivos enviados).
• Reconstruir Tabelas de Rastreamento: Recria as tabelas usadas pelo plugin para rastrear arquivos enviados (use apenas se as tabelas estiverem corrompidas).

Verificação de Consistência

A Verificação de Consistência é uma das ferramentas mais úteis para manutenção. Ela compara os registros locais do WordPress com os arquivos reais armazenados no Cloudflare R2 para identificar qualquer inconsistência:

Como Usar a Verificação de Consistência

1. Na página de Manutenção, localize a seção "Ferramentas de Consistência".
2. Clique no botão Iniciar Verificação de Consistência.
3. Selecione as opções desejadas:
   • Verificar Arquivos Estáticos: Inclui JS, CSS, fontes e outros arquivos estáticos na verificação.
   • Verificar Imagens: Inclui imagens e miniaturas na verificação.
   • Verificar Formatos Modernos: Inclui versões WebP e AVIF na verificação.
   • Modo de Verificação: Escolha entre verificação rápida (apenas existência de arquivos) ou completa (também verifica tamanho e hash).
4. Clique em Iniciar Verificação para começar o processo.

Resultados da Verificação

Após a conclusão da verificação, você verá um relatório detalhado com as seguintes categorias:

• Consistente: Arquivos que existem tanto nos registros locais quanto no R2.
• Apenas Local: Arquivos que existem nos registros locais, mas não foram encontrados no R2.
• Apenas R2: Arquivos que existem no R2, mas não têm registros correspondentes no WordPress.
• Tamanho Diferente: Arquivos que existem em ambos os lugares, mas com tamanhos diferentes.
• Conteúdo Diferente: Arquivos que existem em ambos os lugares, mas com hash/conteúdo diferente.

Corrigindo Inconsistências

Para cada categoria de inconsistência, você terá opções para resolver os problemas:

• Reenviar para R2: Envia novamente os arquivos que existem localmente mas não no R2.
• Adicionar ao Registro: Adiciona registros locais para arquivos que existem no R2 mas não nos registros do WordPress.
• Remover do R2: Exclui arquivos do R2 que não têm registros correspondentes no WordPress.
• Remover do Registro: Remove registros locais de arquivos que não existem no R2.
• Atualizar no R2: Substitui os arquivos no R2 com versões locais para arquivos com tamanho ou conteúdo diferente.

Você pode selecionar quais ações aplicar a cada categoria ou aplicar ações em lote para resolver todas as inconsistências de uma vez.

Limpeza de Banco de Dados

Com o tempo, as tabelas do banco de dados do plugin podem acumular registros desnecessários, aumentando o tamanho do banco de dados e potencialmente reduzindo o desempenho:

Como Usar a Limpeza de Banco de Dados

1. Na página de Manutenção, localize a seção "Ferramentas de Recuperação".
2. Clique no botão Limpar Registros Órfãos.
3. Selecione as opções desejadas:
   • Registros de Arquivos Excluídos: Remove registros de arquivos que foram excluídos da biblioteca de mídia.
   • Registros de Uploads Antigos: Remove registros de tentativas de upload antigas e malsucedidas.
   • Logs Antigos: Remove entradas de log com mais de um determinado período.
   • Dados de Cache: Limpa dados de cache que podem estar ocupando espaço desnecessário.
4. Clique em Iniciar Limpeza para começar o processo.

Após a conclusão, você verá um relatório detalhando quantos registros foram removidos de cada tabela e o espaço total recuperado no banco de dados.

Manutenção Programada

Para manter seu CDN funcionando de forma ideal, é recomendável realizar tarefas de manutenção regularmente. O plugin permite automatizar essas tarefas:

Configurando Manutenção Programada

1. Na página de Manutenção, localize a seção "Manutenção Programada".
2. Ative a opção Habilitar Manutenção Programada.
3. Configure quais tarefas de manutenção devem ser executadas automaticamente:
   • Verificação de Consistência: Executa verificações periodicamente e notifica sobre inconsistências.
   • Limpeza de Banco de Dados: Remove registros órfãos e dados desnecessários periodicamente.
   • Atualização de Estatísticas: Recalcula estatísticas para garantir precisão no painel.
   • Sincronização de Registros: Mantém os registros locais sincronizados com o R2.
4. Defina a frequência para cada tarefa (diária, semanal, quinzenal ou mensal).
5. Configure opções de notificação para ser informado sobre os resultados das tarefas de manutenção.
6. Clique em Salvar Configurações para aplicar as alterações.

Logs do Sistema

O plugin mantém logs detalhados de todas as operações relacionadas ao R2, o que pode ser útil para identificar e resolver problemas:

Visualizando Logs

1. Na página de Manutenção, localize a seção "Logs do Sistema".
2. Você verá uma interface para filtrar e visualizar logs:
   • Tipo de Log: Filtre por uploads, otimização, erros, etc.
   • Intervalo de Datas: Visualize logs de um período específico.
   • Nível de Log: Filtre por informações, avisos ou erros.
   • Pesquisa: Busque por termos específicos nos logs.
3. Clique em Aplicar Filtros para ver os logs correspondentes.

Exportando Logs

Você pode exportar os logs para análise posterior ou para compartilhar com o suporte técnico:

1. Aplique os filtros desejados para restringir quais logs serão exportados.
2. Clique no botão Exportar Logs.
3. Escolha o formato de exportação (CSV, JSON ou texto).
4. O download do arquivo de log será iniciado automaticamente.

Configurações de Log

Você pode personalizar como o plugin registra informações:

• Nível de Detalhe: Defina quanta informação é registrada (mínimo, normal, verboso).
• Período de Retenção: Defina por quanto tempo os logs são mantidos antes de serem automaticamente excluídos.
• Logs em Arquivo: Ative esta opção para salvar os logs também em arquivos no servidor, além do banco de dados.
• Notificações de Erro: Configure o plugin para enviar notificações por e-mail quando erros críticos ocorrerem.

Diagnóstico de Performance

O plugin inclui ferramentas para analisar a performance do seu CDN e identificar possíveis gargalos:

Teste de Velocidade CDN

1. Na página de Manutenção, localize a seção "Diagnóstico de Performance".
2. Clique no botão Iniciar Teste de Velocidade.
3. O plugin realizará uma série de testes:
   • Velocidade de carregamento de arquivos do seu servidor.
   • Velocidade de carregamento dos mesmos arquivos do Cloudflare R2.
   • Latência entre seu servidor e o Cloudflare R2.
   • Distribuição geográfica do desempenho (se disponível).
4. Após a conclusão, você verá um relatório comparando o desempenho do seu servidor com o CDN.

Este teste é útil para confirmar que o CDN está realmente melhorando a velocidade do seu site e para identificar arquivos que podem não estar sendo servidos corretamente.

Análise de Recursos

Esta ferramenta analisa o uso de recursos do plugin em seu servidor:

1. Clique no botão Analisar Uso de Recursos.
2. O plugin monitorará seu uso de memória, CPU e operações de banco de dados durante várias operações comuns.
3. Após a conclusão, você verá um relatório detalhado sobre o impacto do plugin em seu servidor.

Se você estiver enfrentando problemas de desempenho, esta análise pode ajudar a identificar configurações que precisam ser ajustadas para reduzir a carga no servidor.

Manutenção do Bucket R2

Além de manter a sincronização entre WordPress e R2, também é importante realizar manutenção no próprio bucket R2:

Otimizar Armazenamento

Esta ferramenta ajuda a otimizar o uso de armazenamento no seu bucket R2:

1. Clique no botão Otimizar Armazenamento R2.
2. Selecione as opções desejadas:
   • Remover Duplicatas: Identifica e remove arquivos duplicados.
   • Consolidar Versões: Combina múltiplas versões do mesmo arquivo.
   • Remover Arquivos Temporários: Limpa arquivos temporários ou parciais deixados por uploads incompletos.
   • Reorganizar Estrutura: Reorganiza a estrutura de pastas para maior eficiência (avançado).
3. Clique em Iniciar Otimização para começar o processo.

Backup do Bucket

Para segurança adicional, você pode criar backups do seu bucket R2:

1. Clique no botão Iniciar Backup do Bucket.
2. Selecione as opções de backup:
   • Backup Completo: Copia todos os arquivos do bucket.
   • Backup Incremental: Copia apenas arquivos novos ou modificados desde o último backup.
   • Apenas Arquivos Críticos: Faz backup apenas de arquivos essenciais, excluindo formatos alternativos que podem ser recriados.
3. Escolha o destino do backup (outro bucket R2, servidor local, ou download).
4. Clique em Iniciar Backup para começar o processo.

Melhores Práticas de Manutenção

Para manter seu CDN funcionando de forma eficiente, recomendamos as seguintes rotinas de manutenção:

Manutenção Mensal

• Execute uma verificação de consistência completa para identificar e corrigir inconsistências.
• Limpe registros órfãos do banco de dados para manter seu tamanho sob controle.
• Verifique os logs em busca de erros recorrentes que possam indicar problemas subjacentes.
• Execute um teste de velocidade para confirmar que o CDN continua oferecendo melhorias de desempenho.

Manutenção Trimestral

• Otimize o armazenamento do bucket R2 para reduzir custos e melhorar a eficiência.
• Revise e ajuste as configurações de otimização com base na evolução das necessidades do seu site.
• Crie um backup completo do bucket para proteger contra perda de dados.
• Considere reprocessar imagens se novos algoritmos de otimização estiverem disponíveis.

Após Grandes Mudanças

Após realizar grandes alterações no seu site, como mudança de tema, migração de servidor ou atualização significativa de plugins, é recomendável:

• Executar uma verificação de consistência completa para garantir que tudo continue sincronizado.
• Verificar se novos tamanhos de imagem foram adicionados e precisam ser enviados para o R2.
• Confirmar que as URLs estão sendo corretamente modificadas para apontar para o CDN.
• Verificar a compatibilidade com outros plugins que possam ter sido atualizados ou instalados.