> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/resolucao-de-problemas-e-faq/troubleshooting/package-installation-issues/analysing-chocolatey.log.md).
# Análise de chocolatey.log
## Requisitos
Os seguintes itens são necessários ou úteis para a resolução de problemas:
* Arquivos de log, especialmente `chocolatey.log`.
* Editor de texto de sua escolha com recursos avançados de pesquisa, recomendado: Notepad++, Visual Studio Code.
* ID do pacote com falha, como `generic-mozilla-firefox`.
* Carimbo de data/hora da(s) instalação(ões) com falha (não obrigatório, mas útil).
## Estrutura do arquivo de log
### Ponto de entrada e informações de depuração
Para encontrar o ponto de entrada da instalação do pacote dentro do `chocolatey.log` use esta string de pesquisa exata (adapte o ID do pacote conforme necessário): `generic-mozilla-firefox --version=` (se você tiver certeza da string de versão, pode adicioná-la, é claro, mas não é obrigatório)
Dessa forma, você encontrará o(s) ponto(s) de início do processo do choco para a instalação ou atualização do ID de pacote informado.
A linha completa no log pode parecer assim, em vez de `atualização` também pode ser `instalação` dependendo da operação:
{% code overflow="wrap" fullWidth="false" %}
```log
2023-08-22 15:05:36,664 [DEBUG] - Linha de comando: "C:\ProgramData\chocolatey\choco.exe" upgrade generic-mozilla-firefox --version=117.0.0.0 --force --yes --ignore-package-exit-codes --timeout=14400 --params="/BlockAddons:1"
```
{% endcode %}
Ponto de entrada de uma instalação do choco dentro de chocolatey.log
Esta linha já contém algumas informações importantes, como o número da versão do pacote a ser instalado, bem como os parâmetros usados (argumentos do pacote configurados no RealmJoin Portal).
As linhas a seguir conterão muitas informações de depuração (não relevantes), entre outras, o conteúdo completo de chocolateyInstall.ps1 será exibido.\
Nas informações de depuração, você verá as duas seções `RJAppDeployToolkit: Variáveis de ambiente de entrada` e `RJAppDeployToolkit: Variáveis resultantes`. Ambas as seções ficam lado a lado e mostram variáveis e valores fornecidos pelo `RJAppDeployToolkit`
Saída do RJAppDeployToolkit
### Processo de instalação
O script de instalação do pacote propriamente dito começa após a seguinte mensagem de log:
{% code overflow="wrap" %}
```log
2023-08-22 15:05:47,000 [DEBUG] - Executando 'C:\ProgramData\chocolatey\lib\generic-mozilla-firefox\tools\chocolateyInstall.ps1'
```
{% endcode %}
Dependendo do script de instalação do pacote e do estado do cliente, a primeira etapa normalmente será verificar se o software já está instalado. Isso é feito para determinar se será necessária uma desinstalação antes da instalação propriamente dita.\
Nos logs, isso pode ser acompanhado usando uma ou mais das seguintes mensagens de log:
{% code overflow="wrap" %}
```log
2023-08-22 15:05:47,057 [DEBUG] - Entrou na função 'Get-RealmjoinRegistryUninstallInfo' com parâmetros [...]]
```
{% endcode %}
{% code overflow="wrap" %}
```log
2023-08-22 15:05:47,053 [DEBUG] - Entrou na função 'Uninstall-RealmjoinPackage' com parâmetros [...]]
```
{% endcode %}
Após as verificações e possíveis desinstalações terem sido executadas, a instalação principal da aplicação será iniciada, indicada pela seguinte mensagem de log (o nome do arquivo, claro, será diferente):
{% code overflow="wrap" %}
```log
2023-08-22 15:05:47,858 [INFO ] - Iniciando o RealmJoin-Install de Git-2.42.0-64-bit.exe
```
{% endcode %}
A instalação normalmente começa com o download do arquivo binário. O início e o fim do download são representados pelas seguintes mensagens de log:
{% code overflow="wrap" %}
```log
2023-08-22 15:05:48,273 [INFO ] - Baixando generic-git-git de 'https://cdn.realmjoin.com/blobs/generic/generic-git-git/Git-2.42.0-64-bit.exe'
[...]
2023-08-22 15:05:57,293 [INFO ] - Download de Git-2.42.0-64-bit.exe (58.35 MB) concluído.
```
{% endcode %}
Após concluir o download, o chocolatey verificará o hash do arquivo baixado e o comparará com o valor esperado. Se os hashes coincidirem, o arquivo de instalação finalmente será executado.\
A mensagem de log para a execução pode ser encontrada pela seguinte mensagem de log:
{% code overflow="wrap" %}
```log
2023-08-22 15:06:00,743 [DEBUG] - Elevando permissões e executando ["C:\WINDOWS\TEMP\chocolatey\generic-git-git\2.42.0.0\Git-2.42.0-64-bit.exe" /verysilent /norestart /log="C:\WINDOWS\Logs\RealmJoin\Packages\generic-git-git\2023-08-22_15-05-47.916_generic-git-git_2.42.0.0_install_Git-2.42.0-64-bit.exe.log" ]. Isso pode levar um tempo, dependendo das instruções.
```
{% endcode %}
Esta mensagem inclui o caminho do arquivo para o instalador, bem como a linha de comando completa, incluindo todos os parâmetros (silenciosos) usados para iniciar o instalador. Também ajudará a encontrar o caminho relevante do arquivo de log da instalação, se oferecido pelo instalador e incluído no script do pacote.
Após o processo sair, outra mensagem de log será gravada, novamente incluindo o caminho completo do arquivo e todos os parâmetros. Além disso, esta mensagem também incluirá o código de saída retornado pelo processo de instalação, o indicador mais importante de uma instalação bem-sucedida ou malsucedida:
{% code overflow="wrap" %}
```log
2023-08-22 15:06:52,321 [DEBUG] - Comando ["C:\WINDOWS\TEMP\chocolatey\generic-git-git\2.42.0.0\Git-2.42.0-64-bit.exe" /verysilent /norestart /log="C:\WINDOWS\Logs\RealmJoin\Packages\generic-git-git\2023-08-22_15-05-47.916_generic-git-git_2.42.0.0_install_Git-2.42.0-64-bit.exe.log" ] saiu com '0'.
```
{% endcode %}
Dependendo do pacote, a instalação pode agora ser seguida pelas chamadas 'postActions', que podem ser algumas configurações de registro, remoção de ícones da área de trabalho ou até mesmo a execução de outro arquivo de instalação (reiniciando com o download desse arquivo). A parte de postActions será indicada pelas seguintes mensagens de início e fim no arquivo de log:
{% code overflow="wrap" %}
```log
2023-09-13 16:49:18,550 7224 [INFO ] - Executando postActions...
2023-09-13 16:49:20,894 7224 [INFO ] - postActions concluídas.
```
{% endcode %}
O processo de instalação do chocolatey será encerrado com a seguinte mensagem de log (a redação pode variar dependendo de instalação / atualização ):
{% code overflow="wrap" %}
```log
2023-09-13 17:01:39,433 8336 [INFO ] - A instalação de generic-google-chrome foi bem-sucedida.
```
{% endcode %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.realmjoin.com/pt/resolucao-de-problemas-e-faq/troubleshooting/package-installation-issues/analysing-chocolatey.log.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.