Esta é a documentação do Looker. Para acessar a documentação do Looker Studio, acesse https://support.google.com/looker-studio.

Como criar backups

Para instâncias hospedadas pelo cliente, você pode criar um backup de uma instalação básica do Looker fazendo uma cópia do diretório inicial do usuário do Looker (incluindo todos os subdiretórios normais e ocultos). Isso pode ser feito por meio do scp, do rsync ou de qualquer aplicativo de backup padrão. Da mesma forma, para restaurar uma instalação básica do Looker, basta restaurar os arquivos e inicializar o Looker.

Em algumas configurações, incluindo ambientes em cluster, o Looker usa um banco de dados MySQL externo para definir as configurações do aplicativo, contas de usuário e outros dados. Nesse caso, recomendamos criar um backup do banco de dados MySQL, além do diretório principal do Looker.

É altamente recomendável criar esses backups diariamente. Também recomendamos fazer um teste de restauração uma vez por trimestre.

Estrutura do diretório

Os subdiretórios padrão no diretório principal do usuário do Looker (geralmente /home/looker) são descritos aqui.

Página inicial do
- Looker:
- .ssh
- Looker
  - .cache
  - .db
  - .ssl
  - .tmp
  - deploy_keys
  - Registro de
  - modelos
  - modelos-user-1

Diretório	Backup necessário	Frequência de alteração	Descrição
.ssh	Sim	Rara	Chaves SSH usadas para autenticação no Git em projetos LookML criados com o Looker 4.6 ou versões anteriores
looker/.cache	Não	Frequentes	Arquivos temporários em cache
looker/.db	Sim, a menos que o banco de dados de back-end tenha sido migrado para o MySQL	Frequentes	Banco de dados interno do Looker
looker/.snapshots	Não	Ao atualizar	Uma cópia de backup do jar do Looker e do diretório .db são armazenadas aqui durante as atualizações
looker/.ssl	Talvez	Rara	Certificados SSL autoassinados. Consulte a observação.
looker/.tmp	Não	Frequentes	Arquivos temporários
looker/deploy_keys	Sim	Rara	Chaves SSH usadas para autenticação no Git para projetos LookML criados com o Looker 4.8 ou mais recente
looker/log	Talvez	Frequentes	Arquivos de registros: necessários apenas se exigido pelas políticas de retenção
looker/models	Não	Variável	modelos Production, copiados do repositório de origem (geralmente GitHub)
looker/models-user-*	Sim	Variável	Os modelos de desenvolvimento de cada usuário são armazenados em diretórios separados com o número do ID

Observação sobre SSL:por padrão, o diretório SSL contém apenas um certificado SSL autoassinado, que não precisa ser mantido. No entanto, se você armazenar arquivos adicionais nesse diretório, por exemplo, certificados SSL assinados por uma autoridade de certificação, o diretório precisará ser adicionado ao backup.

Os arquivos fora do diretório principal do Looker, que precisam ser adicionados ao seu backup, são:

Diretório	Backup necessário	Frequência de alteração	Descrição
/etc/init.d/looker	Sim	Rara	Script de inicialização do sistema para o Looker
Certificados SSL	Sim	Rara	Se você estiver usando certificados SSL, verifique se todos os arquivos necessários estão incluídos

Embora isso normalmente não cause problemas, alguns clientes relataram problemas quando incluem o arquivo looker/.db/looker.lck nos backups. Você pode excluir esse arquivo com segurança, se necessário.

Como criar um backup do Looker

É possível criar um backup do Looker com qualquer aplicativo de backup padrão ou com ferramentas de linha de comando, como o rsync.

Recomendamos que o processo de backup seja executado quando o aplicativo for pouco usado. Além da interação normal do usuário, considere os horários em que os Looks programados podem estar em execução, as tabelas derivadas podem estar sendo recriadas etc.

Ambientes em cluster

Os Lookers em cluster armazenam a configuração do aplicativo, as contas de usuário e outros dados em um banco de dados MySQL externo. Recomendamos criar um backup desse banco de dados ao mesmo tempo que o aplicativo Looker. Consulte a documentação do MySQL para mais detalhes sobre como fazer backup de bancos de dados MySQL.

Como gerar um backup independente de keystore

Uma instalação hospedada pelo cliente que migrou para a criptografia AES-256 GCM e não usa o AWS KMS pode usar este procedimento para criar um backup da instância do Looker independente da chave mestra do cliente (CMK) local. Isso oferece um método para um cliente auto-hospedado migrar para uma instalação hospedada pelo Looker sem precisar fornecer o CMK ou mover uma instalação hospedada pelo cliente para um novo host que não tenha acesso ao mesmo keystore local.

Para criar um backup independente de keystore:

Parar o Looker:
```
cd looker
./looker stop
```
Se o Looker estiver em cluster, interrompa todos os nós antes de continuar.
Verifique se o Looker pode acessar seu CMK. Se o CMK estiver armazenado em um arquivo, use a variável de ambiente LKR_MASTER_KEY_FILE para apontar para o caminho desse arquivo:
```
export LKR_MASTER_KEY_FILE=<path_to_CMK_file>
```
Ou, para fornecer o CMK diretamente em uma variável de ambiente, use a variável de ambiente LKR_MASTER_KEY_ENV:
```
export LKR_MASTER_KEY_ENV=<CMK_value>
```
Gere um novo arquivo de chave que será usado para recriptografar a chave de criptografia de chaves (KEK, na sigla em inglês):
```
./looker generate_keyfile_for_backup <key_file_name>
```
Em que <key_file_name> é o nome do arquivo que o Looker criará e usará para gravar a nova chave.

O conteúdo do novo arquivo de chave será semelhante a este:
```
{"dbmk":"vr1LUwO3q6weY8iS3JykVljSjiD4m6eGk227Cs7Qu9Q=\n","backup_uid":"XCXvRa38mNeqT6+HRBCo2Q=="}
```
Em que o valor de dbmk é uma chave de criptografia de 256 bits com codificação Base64 e backup_uid é um nome exclusivo usado ao salvar a chave no banco de dados.
Use o novo arquivo de chave para criar uma entrada de chave no banco de dados interno do Looker:
```
./looker keystore_independent_recrypt <key_file_name>
```
em que <key_file_name> é o arquivo de chave criado anteriormente.

Isso descriptografa a KEK no banco de dados interno usando a CMK, depois recriptografa a KEK com a nova chave e mantém o valor criptografado no banco de dados.
Crie um backup do Looker usando seu método de backup normal.

Para restaurar esse backup independente de keystore, você precisará do novo arquivo de chave criado anteriormente.

Como restaurar backups

Para restaurar um backup do Looker, consulte a página de documentação Como restaurar backups.

Próximas etapas

Depois de configurar os backups, você vai estar pronto para garantir que o Looker tenha acesso aos serviços necessários.