Como criar um banco de dados de réplica de leitura de atividade do sistema
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O recurso Atividade do sistema de elite está disponível apenas para instâncias hospedadas pelo Looker. Para instâncias hospedadas pelo cliente, é possível criar uma réplica de leitura do banco de dados de back-end do Looker para aproveitar alguns dos benefícios da atividade do sistema Elite.
Para configurar uma réplica de leitura do banco de dados de back-end do MySQL e configurar o Looker para usar a réplica de leitura nas consultas de atividade do sistema:
Crie uma réplica de leitura do banco de dados de back-end do MySQL. Por exemplo, para criar uma réplica de leitura do MySQL na AWS, siga as instruções na documentação Como trabalhar com réplicas de leitura da Amazon. Salve o identificador da instância do banco de dados e o número da porta. Você vai precisar deles para configurar o Looker na próxima etapa.
Na instância do Looker, crie um arquivo yaml chamado sa-db, contendo o seguinte:
Inicie o Looker com a opção de inicialização--internal-analytics-connection-file sa-db.yml. Isso configura o Looker para usar o banco de dados de réplica de leitura configurado em sa-db.yml nas consultas de atividade do sistema.
Também é possível usar as seguintes opções de inicialização para modificar a configuração da atividade do sistema Elite:
--internal-analytics-retention-days=<number>: por padrão, a atividade do sistema armazena 90 dias de dados históricos. Use essa opção de inicialização para especificar quantos dias de dados históricos a Atividade do sistema vai armazenar. Não recomendamos aumentar a retenção de dados além de 90 dias, mas você pode reduzir a duração da retenção de dados para melhorar o desempenho. Se você quiser aumentar a retenção de dados históricos além dos 90 dias padrão, pergunte ao executivo de contas sobre a hospedagem do Looker com a opção Atividade do sistema Elite.
Se você quiser mais dias do que o padrão, pergunte ao seu executivo de conta sobre a hospedagem do Looker com a opção de atividade do sistema Elite.
- --internal-analytics-connection-pool-size=<number>: por padrão, as consultas de atividade do sistema são limitadas a um tamanho de pool de conexões de banco de dados de 1, o que significa que várias consultas de análise do sistema serão enfileiradas e executadas em série no banco de dados de back-end. Isso protege o banco de dados interno contra sobrecarga com consultas do Google Analytics para sistemas. Use essa opção de inicialização para especificar o número de consultas simultâneas da Análise do sistema que podem ser executadas. Por exemplo, 8.
Depois de configurado para usar o banco de dados de réplica de leitura para consultas de atividade do sistema, o Looker vai continuar usando o banco de dados MySQL principal como o banco de dados interno do aplicativo. Os painéis de atividade do sistema e os recursos de análise detalhada vão usar o banco de dados de réplica de leitura.
Para verificar se o Looker está usando o banco de dados de réplica de leitura para consultas de atividade do sistema:
Se você mudar a senha no arquivo sa-db.yml, as consultas de atividade do sistema vão retornar um erro.
No banco de dados MySQL, é possível executar show processlist; para conferir os processos em execução. O banco de dados principal do Looker mostra muitas conexões abertas que estão em estado de suspensão, enquanto o banco de dados looker__internal__analytics mostra consultas analíticas.
Os painéis e análises de atividades do sistema vão usar o banco de dados de réplica de leitura, mas as análises i__looker legadas ainda vão consultar o banco de dados principal de back-end. Atualize todos os Looks ou painéis salvos que consultam i__looker para que eles consultem a atividade do sistema. Use os métodos descritos nesta página de documentação para garantir que todos os Looks e painéis salvos estejam consultando a conexão correta com o banco de dados de réplica de leitura.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-31 UTC."],[],[],null,["# Creating a System Activity read replica database\n\nThe [Elite System Activity](/looker/docs/elite-system-activity) feature is available only for Looker-hosted instances. For customer-hosted instances, you can create a read replica of the Looker backend database to gain some of the benefits of Elite System Activity.\n\u003e To use this option, your instance must be configured to [use a MySQL backend database](/looker/docs/migrating-looker-backend-db-to-mysql).\n\u003e\n\u003e This option is available for customer-hosted instances only. For Looker-hosted instances, please [contact a Google Cloud sales specialist](https://cloud.google.com/contact).\n\nTo set up a read replica of your MySQL backend database and configure Looker to use the read replica for System Activity queries:\n\n1. Create a read replica of your MySQL backend database. For example, to create a MySQL read replica in AWS, follow the instructions in [Amazon's Working with Read Replicas](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html) documentation. Save the DB instance identifier and port number, you'll need those to configure Looker in the next step.\n\n2. On your Looker instance, create a `yaml` file named `sa-db`, containing the following:\n\n dialect: mysql\n host: \u003cDB instance identifier\u003e\n username: root\n password: \u003cpassword\u003e\n database: looker\n port: \u003cDB instance port\u003e\n\n3. Stop Looker.\n\n4. Start Looker with the [startup option](/looker/docs/startup-options) `--internal-analytics-connection-file sa-db.yml`. This configures Looker to use the read replica database configured in `sa-db.yml` for System Activity queries.\n\n5. Optionally, you can also use the following startup options to modify your Elite System Activity configuration:\n\n - `--internal-analytics-retention-days=\u003cnumber\u003e`: By default, System Activity stores 90 days of historical data. Use this startup option to specify how many days of historical data System Activty will store. We do not recommend increasing data retention beyond 90 days, but you can reduce the length of data retention to improve performance. If you want to increase historical data retention beyond the default 90 days, ask your account executive about Looker hosting with the [Elite System Activity](/looker/docs/elite-system-activity) option.\n\n If you want more days than the default, ask your account executive about Looker hosting with the Elite System Activity option\n - `--internal-analytics-connection-pool-size=\u003cnumber\u003e`: By default, System Activity queries are limited to a database connection pool size of 1, meaning that multiple System Analytics queries will queue and run serially in the backend database. This protects the internal database from being overloaded with System Analytics queries. Use this startup option to specify the number of concurrent System Analytics queries that can be run simultaneously. For example, 8.\n\nOnce configured to use the read replica database for System Activity queries, Looker will continue to use main MySQL database as the internal application database. System Activity dashboards and Explores will use the read replica database.\n\nTo verify that Looker is using the read replica database for System Activity queries:\n\n- If you change the password in the `sa-db.yml` file, System Activity queries will return an error.\n- On the MySQL database, you can run `show processlist;` to see the current running processes. The main Looker database should show many open connections that are in a sleep state, while the `looker__internal__analytics` database will show analytical queries.\n\n\u003e System Activity dashboards and Explores will use the read replica database, but the legacy `i__looker` Explores will still query the primary backend database. Update any saved Looks or dashboards that query `i__looker` to cause them to query System Activity. Use the methods described on this documentation page to ensure that any saved Looks and dashboards are querying the correct connection to the read replica database."]]