Este é um guia de referência para descrever como funcionam os Relatórios do Painel Administrativo, os dados que eles exibem, as consultas SQL correspondentes do Data Explorer e onde encontrar o código Ruby de cada relatório.
Nível de usuário necessário: Staff
O Discourse contém vários Relatórios do Painel Administrativo integrados que podem ser úteis para explorar estatísticas sobre uma comunidade. Para acessar esses relatórios, você pode visitar discourse.example.com/admin/dashboard/reports no seu site (ou clicar no link Relatórios na barra lateral). Observe que apenas usuários staff terão acesso a esses relatórios.
Os dados de todos os usuários de um site estão incluídos nestes relatórios (incluindo a atividade de staff, como a visita a páginas administrativas). A única condição imposta aos usuários nos relatórios é que sejam usuários ‘reais’, o que é usado para excluir o usuário system dos relatórios.
Plugins também podem adicionar relatórios ao painel com add_report(name, &block).
Os modelos Ruby para a maioria dos relatórios estão localizados em: discourse/app/models/concerns/reports/. Alguns relatórios também fazem referência a: discourse/app/models/report.rb
Os tópicos dashboard-sql contêm todas as consultas SQL correspondentes que podem ser usadas para gerar relatórios idênticos aos Relatórios do Painel Administrativo. Essas consultas podem ser usadas dentro do plugin Data Explorer e para Executar consultas do Data Explorer com a API do Discourse
Para ocultar relatórios específicos do painel, use a configuração do site
dashboard_hidden_reports.
Soluções Aceitas
Exibe a contagem diária de posts marcados como soluções.
Código Ruby: discourse-solved/plugin.rb at main · discourse/discourse-solved · GitHub
Consulta SQL: Dashboard Report - Accepted Solutions
Logins de Administradores
Lista de horários de login de administradores com localizações.
Código Ruby: discourse/app/models/concerns/reports/staff_logins.rb
Consulta SQL: Dashboard Report - Admin Logins
Anônimos
Número de novas visualizações de página por visitantes não conectados a uma conta.
Código Ruby: discourse/app/models/concerns/reports/consolidated_page_views.rb
Consulta SQL: Dashboard Report - Anonymous
Favoritos
Número de novos tópicos e posts marcados como favoritos.
Código Ruby: discourse/app/models/concerns/reports/bookmarks.rb
Consulta SQL: Dashboard Report - Bookmarks
Requisições de API Consolidadas
Estatísticas de uso da API por data, rastreando tanto requisições de API regulares quanto requisições de API de usuários.
Código Ruby: discourse/app/models/concerns/reports/consolidated_api_requests.rb at main · discourse/discourse · GitHub
Consulta SQL: Dashboard Report - Consolidated API Requests
Visualizações de Página Consolidadas
Visualizações de página para usuários conectados, usuários anônimos e rastreadores. Este é um relatório legado substituído pelo relatório Tráfego do Site.
Código Ruby: discourse/app/models/concerns/reports/consolidated_page_views.rb
Consulta SQL: Dashboard Report - Consolidated Pageviews
Visualizações de Página Consolidadas com Detecção de Navegador (Descontinuado)
Visualizações de página para usuários conectados, usuários anônimos, rastreadores conhecidos e outros. Este relatório está descontinuado e agora delega para o relatório Tráfego do Site.
Código Ruby: discourse/app/models/concerns/reports/consolidated_page_views_browser_detection.rb
Consulta SQL: Dashboard Report - Consolidated Pageviews with Browser Detection
DAU/MAU
Número de membros que fizeram login no último dia dividido pelo número de membros que fizeram login no último mês – retorna uma % que indica a ‘retenção’ da comunidade. O objetivo é ser >20%.
Código Ruby: discourse/app/models/concerns/reports/dau_by_mau.rb
Consulta SQL: Dashboard Report - DAU/MAU
Usuários Engajados Diariamente
Número de usuários que curtiram ou publicaram no último dia.
Código Ruby: discourse/app/models/concerns/reports/daily_engaged_users.rb
Consulta SQL: Dashboard Report - Daily Engaged Users
E-mails Enviados
Número de novos e-mails enviados.
Código Ruby: discourse/app/models/concerns/reports/emails.rb
Consulta SQL: Dashboard Report - Emails Sent
Bandeiras
Número de novas bandeiras.
Código Ruby: discourse/app/models/concerns/reports/flags.rb
Consulta SQL: Dashboard Report - Flags
Status das Bandeiras
Lista de status das bandeiras, incluindo o tipo de bandeira, o autor, quem reportou e o tempo até a resolução.
Código Ruby: discourse/app/models/concerns/reports/flags_status.rb
Consulta SQL: Dashboard Report - Flags Status
Curtidas
Número de novas curtidas.
Código Ruby: discourse/app/models/concerns/reports/likes.rb
Consulta SQL: Dashboard Report - Likes
Conectados
Número de novas visualizações de página de usuários conectados.
Código Ruby: discourse/app/controllers/admin/reports_controller.rb#L5
Consulta SQL: Dashboard Report - Logged In
Atividade de Moderadores
Lista de atividades de moderadores, incluindo bandeiras revisadas, tempo de leitura, tópicos criados, posts criados, mensagens pessoais criadas e revisões.
Consulta SQL: Dashboard Report - Moderator Activity
Advertência de Moderador
Número de advertências enviadas por mensagens pessoais de moderadores.
Código Ruby: discourse/app/models/concerns/reports/moderator_warning_private_messages.rb
Consulta SQL: Dashboard Report - Moderator Warnings
Novos Contribuidores
Número de usuários que fizeram seu primeiro post durante este período.
Código Ruby: discourse/app/models/concerns/reports/new_contributors.rb
Consulta SQL: Dashboard Report - New Contributors
Notificar Moderadores
Número de vezes que moderadores foram notificados privadamente por uma bandeira.
Código Ruby: discourse/app/models/concerns/reports/notify_moderators_private_messages.rb
Consulta SQL: Dashboard Report - Notify Moderators
Notificar Usuário
Número de vezes que usuários foram notificados privadamente por uma bandeira.
Código Ruby: discourse/app/models/concerns/reports/notify_user_private_messages.rb
Consulta SQL: Dashboard Report - Notify User
Sentimento Geral
Número de posts classificados como positivos ou negativos pela IA “Sentiment”, em um período especificado.
Código Ruby: https://github.com/discourse/discourse-ai/blob/main/lib/sentiment/entry_point.rb
Consulta SQL: Dashboard Report - Overall Sentiment
Visualizações de Página
Número de novas visualizações de página de todos os visitantes. Igual ao total de Visualizações de Página Consolidadas.
O Discourse usa a seguinte consulta para determinar o total de visualizações de página:
Consulta SQL: Dashboard Report - Consolidated Pageviews
Edições de Posts
Número de novas edições de posts.
Código Ruby: discourse/app/models/concerns/reports/post_edits.rb
Consulta SQL: Dashboard Report - Post Edits
Posts
Novos posts criados durante o período de tempo selecionado
Código Ruby: discourse/app/models/concerns/reports/posts.rb
Consulta SQL: Dashboard Report - Posts
Emoção do Post
Número de posts classificados pela IA com uma das seguintes emoções: Tristeza, Surpresa, Medo, Raiva, Alegria, Nojo - agrupado por nível de confiança do autor, em um período especificado.
Código Ruby: https://github.com/discourse/discourse-ai/blob/main/lib/sentiment/entry_point.rb
Consulta SQL: Dashboard Report - Post Emotion
Reações
Lista das reações mais recentes.
Código Ruby: discourse-reactions/plugin.rb at main · discourse/discourse-reactions · GitHub
Consulta SQL: Dashboard Report - Reactions
Cadastros
Novos registros de conta para este período.
Código Ruby: discourse/app/models/concerns/reports/signups.rb
Consulta SQL: Dashboard Report - Signups
Tráfego do Site
Visualizações de página para navegadores conectados, navegadores anônimos, rastreadores e outros tráfegos. Este é o relatório principal de tráfego, substituindo os relatórios legados de Visualizações de Página Consolidadas.
Código Ruby: discourse/app/models/concerns/reports/site_traffic.rb
Consulta SQL: Dashboard Report - Site Traffic
Logins Suspeitos
Detalhes de novos logins que diferem suspeitamente de logins anteriores.
Código Ruby: discourse/app/models/concerns/reports/suspicious_logins.rb
Consulta SQL: Dashboard Report - Suspicious Logins
Sistema
Número de mensagens pessoais enviadas automaticamente pelo Sistema.
Código Ruby: discourse/app/models/concerns/reports/system_private_messages.rb
Consulta SQL: Dashboard Report - System
Tempo até a primeira resposta
Tempo médio (em horas) da primeira resposta a novos tópicos.
Código Ruby: discourse/app/models/concerns/reports/time_to_first_response.rb + discourse/discourse/blob/main/app/models/topic.rb#L1799-L1844
Consulta SQL: Dashboard Report - Time to First Response
Top Usuários Ignorados / Silenciados
Usuários que foram silenciados e/ou ignorados por muitos outros usuários.
Código Ruby: discourse/app/models/concerns/reports/top_ignored_users.rb
Consulta SQL: Dashboard Report - Top Ignored / Muted Users
Top Tópicos Referenciados
Tópicos que receberam o maior número de cliques de fontes externas.
Código Ruby: discourse/app/models/concerns/reports/top_referred_topics.rb
Consulta SQL: Dashboard Report - Top Referred Topics
Top Referenciadores
Usuários listados pelo número de cliques nos links que compartilharam.
Código Ruby: discourse/app/models/concerns/reports/top_referrers.rb
Consulta SQL: Dashboard Report - Top Referrers
Top Fontes de Tráfego
Fontes externas que mais vincularam para este site.
Código Ruby: discourse/app/models/concerns/reports/top_traffic_sources.rb
Consulta SQL: Dashboard Report - Top Traffic Sources
Top Uploads
Lista todos os uploads por extensão, tamanho do arquivo e autor.
Código Ruby: discourse/app/models/concerns/reports/top_uploads.rb
Consulta SQL: Dashboard Report - Top Uploads
Top Usuários por Curtidas Recebidas
Top 10 usuários que receberam curtidas.
Código Ruby: discourse/app/models/concerns/reports/top_users_by_likes_received.rb
Consulta SQL: Dashboard Report - Top Users by Likes Received
Top Usuários por Curtidas Recebidas de um usuário com nível de confiança mais baixo
Top 10 usuários em um nível de confiança mais alto sendo curtidos por pessoas em um nível de confiança mais baixo.
Código Ruby: discourse/app/models/concerns/reports/top_users_by_likes_received_from_inferior_trust_level.rb
Consulta SQL: Dashboard Report - Top Users by Likes Received from a User with a Lower Trust Level
Top Usuários por Curtidas Recebidas de uma variedade de pessoas
Top 10 usuários que tiveram curtidas de uma ampla gama de pessoas.
Código Ruby: discourse/app/models/concerns/reports/top_users_by_likes_received_from_a_variety_of_people.rb
Consulta SQL: Dashboard Report - Top Users by Likes Received From a Variety of People
Tópicos
Novos tópicos criados durante este período.
Código Ruby: discourse/app/models/concerns/reports/topics.rb
Consulta SQL: Dashboard Report - Topics
Tópicos sem resposta
Número de novos tópicos criados que não receberam uma resposta.
Código Ruby: discourse/app/models/concerns/reports/topics_with_no_response.rb
Consulta SQL: Dashboard Report - Topics with No Response
Estatísticas de Visualização de Tópicos
Top 100 tópicos por visualizações, com divisão entre anônimos e conectados, filtrável por categoria.
Código Ruby: discourse/app/models/concerns/reports/topic_view_stats.rb
Consulta SQL: Dashboard Report - Topic View Stats
Termos de Busca em Alta
Termos de busca mais populares com suas taxas de cliques.
Código Ruby: discourse/app/models/concerns/reports/trending_search.rb
Consulta SQL: Dashboard Report - Trending Search Terms
Crescimento de Nível de Confiança
Número de usuários que aumentaram seu Nível de Confiança durante este período.
O relatório de Crescimento de Nível de Confiança está obtendo dados da tabela user_histories no banco de dados do Discourse. Especificamente, este relatório está contando o número de vezes que uma user_histories.action é registrada para um aumento no nível de confiança de um usuário.
Código Ruby: discourse/app/models/concerns/reports/trust_level_growth.rb
Consulta SQL: Dashboard Report - Trust Level Growth
Políticas não aceitas
Este relatório do painel identifica tópicos com políticas que não foram aceitas por certos usuários.
Código Ruby: discourse-policy/plugin.rb at main · discourse/discourse-policy · GitHub
Consulta SQL: Dashboard Report - Unaccepted Policies
Razão de Reporte de Usuários
Lista de usuários ordenada pela razão de resposta de staff às suas bandeiras (discordância para concordância).
Código Ruby: discourse/app/models/concerns/reports/user_flagging_ratio.rb
Consulta SQL: Dashboard Report - User Flagging Ratio
Notas de Usuário
Lista das notas de usuário mais recentes.
Código Ruby: discourse-user-notes/plugin.rb at main · discourse/discourse-user-notes · GitHub
Consulta SQL: Dashboard Report - User Notes
Visualizações de Perfil de Usuário
Total de novas visualizações de perfis de usuários.
Código Ruby: discourse/app/models/concerns/reports/profile_views.rb
Consulta SQL: Dashboard Report - User Profile Views
Visitas de Usuários
O número total de visitas de usuários conectados no fórum para o período de tempo selecionado (hoje, ontem, últimos 7 dias, etc).
Uma Visita de Usuário é contada sempre que um usuário único conectado visita o site, até uma vez por dia. Por exemplo, se um usuário visitou um site todos os dias dentro de uma semana, o Discourse contaria isso como 7 visitas de usuário.
Código Ruby: discourse/app/models/concerns/reports/visits.rb
Consulta SQL: Dashboard Report - User Visits
Visitas de Usuários (mobile)
Número de usuários únicos conectados que visitaram usando um dispositivo móvel.
Código Ruby: discourse/app/models/concerns/reports/mobile_visits.rb
Consulta SQL: Dashboard Report - User Visits
Usuário-para-Usuário (excluindo respostas)
Número de mensagens pessoais iniciadas.
Código Ruby: discourse/app/models/concerns/reports/user_to_user_private_messages.rb
Consulta SQL: Dashboard Report - User-to-User
Usuário-para-Usuário (com respostas)
Número de todas as novas mensagens pessoais e respostas.
Código Ruby: discourse/app/models/concerns/reports/user_to_user_private_messages_with_replies.rb
Consulta SQL: Dashboard Report - User-to-User
Usuários por Nível de Confiança
Número de usuários agrupados por nível de confiança.
Código Ruby: discourse/app/models/concerns/reports/users_by_trust_level.rb
Consulta SQL: Dashboard Report - Users Per Trust Level
Usuários por Tipo
Número de usuários agrupados por administrador, moderador, suspenso e silenciado.
Código Ruby: discourse/app/models/concerns/reports/users_by_type.rb
Consulta SQL: Dashboard Report - Users Per Type
Visualizações de Página de Rastreadores Web
Total de visualizações de página de rastreadores web ao longo do tempo.
Código Ruby: discourse/app/models/report.rb
Consulta SQL: Dashboard Report - Web Crawler Pageviews
Agentes de Usuário de Rastreadores Web
Lista de agentes de usuário de rastreadores web, ordenados por visualizações de página.
Código Ruby: discourse/app/models/concerns/reports/web_crawlers.rb
Consulta SQL: Dashboard Report - Web Crawler User Agents

