Estava fazendo alguns estudos sobre as ferramentas do Sigstore e acabei me deparando com uma menção a uma ferramenta para manipulação de imagens e registries que eu não conhecia, de nome Crane. Identifiquei logo de cara que havia alguns recursos interessantes que poderiam auxiliar na inspeção e manipulação de imagens. Baixei a ferramenta e comecei os testes. Para o meu caso, que uso o Manjaro, bastou rodar um comando para completar a instalação.

pacman -S crane

Segue abaixo a lista de comandos que achei mais interessante para o meu uso. Para ver todos os subcomandos, basta rodar crane -h.

Exemplos de aplicação

Referência para a lista de comandos:

• https://github.com/google/go-containerregistry/blob/main/cmd/crane/recipes.md

Listar todas as tags de um repositório

crane ls docker.io/library/nginx

Logar em um registry

crane auth login reg.example.com -u AzureDiamond -p hunter2

Inspecionar o config de uma imagem

crane config ubuntu:22.04 | jq

Inspecionar o manifesto de uma imagem

crane manifest ubuntu:22.04 | jq

Exportar o sistema de arquivo do container como um tarball

crane export ubuntu ubuntu.tar

Baixar uma imagem e salvá-la localmente em um tarball

crane pull ubuntu:22.10 ubuntu2210.tar

Listar arquivos de uma imagem

crane export ubuntu - | tar -tvf - | less

Extrair um arquivo de uma imagem

crane export ubuntu - | tar -Oxf - etc/passwd

Observação: certifique de remover a "/" do início do caminho do arquivo.

Crie uma image a partir de um diretório

crane append -f <(tar -f - -c some-dir/) -t ${IMAGE}

Por padrão, isso produz uma imagem com uma camada contendo o conteúdo o diretório. Adicione -b ${BASE_IMAGE} para anexar a camada a uma imagem base.

Esse exemplo carece de validação. Pelos testes que fiz localmente, ele tenta fazer a modificação remotamente no registry.

Verificar a diferença de configs de duas imagens

diff <(crane config busybox:1.32 | jq) <(crane config busybox:1.33 | jq)

Verificar a diferença de manifestos de duas imagens

diff <(crane manifest busybox:1.32 | jq) <(crane manifest busybox:1.33 | jq)

Verificar a diferença do sistema de arquivo

diff \
    <(crane export gcr.io/kaniko-project/executor:v1.6.0-debug - | tar -tvf - | sort) \
    <(crane export gcr.io/kaniko-project/executor:v1.7.0-debug - | tar -tvf - | sort)

Identificar o tamanho da imagem

crane manifest gcr.io/buildpacks/builder:v1 | jq '.config.size + ([.layers[].size] | add)' | numfmt --to=iec

Não sei você, eu uso Linux diariamente no trabalho e mesmo assim não consigo memorizar todos os parâmetros dos comandos que preciso no terminal. Então, a tarefa de ir pesquisar na internet é relativamente comum. E não tem nada de errado com isso, nosso cérebro não consegue fixar todos os detalhes de tudo. Quando preciso pesquisar uma lista rápida com as principais utilizações de um determinado comando, sempre adiciono o seguinte termo na busca: “cheat sheet + o nome do comando”. Esse termo poderia ser traduzido como folha de dicas, e normalmente me traz um resumo com vários exemplos de aplicação daquele determinado comando. Recentemente, resolvi escrever as minhas próprias listas e mantê-las em um controle local usando o Obsidian (aplicação para organizar notas, textos e afins). Esse ato de pesquisa e escrita, reforça muito mais o aprendizado e facilita a minha busca quando eu necessitar. Nesse artigo publicarei minhas notas acerca do comando journalctl.

Descrição

Ferramenta para visualizar os registros do sistema gerados pelo systemd. O arquivo de configuração para esse utilitário está localizado em /etc/systemd/journald.conf. As configurações encontradas nesse arquivo são os valores padrões, mesmo estando comentadas.

Exemplos de utilização

Ao rodar o comando journactl sem parâmetros, é possível navegar pelos registros usando o padrão do less. Caso se queira remover esse comportamento, basta usar o parâmetro --no-pager.

Ordem reversa

journalctl -r

Mais recentes n linhas

journalctl -n 25

Tempo real

journalctl -f

Padrão UTC

Por padrão, os logs são exibidos no horário da máquina. Para exibir em UTC, use o seguinte parâmentro:

journalctl --utc

Logs do kernel

journalctl -k

Logs de um boot específico

Para listar as sessões de boot:

journalctl --list-boots

Exemplo de saída:

  -5 513008ead8464c23aab732a2feed5277 Sun 2020-07-12 20:43:38 IST—Sun 2020-07-12 22:40:02 IST
  -4 caff16e3f46a4479b5287fb9e294f610 Mon 2020-07-13 07:36:04 IST—Mon 2020-07-13 19:13:44 IST
  -3 5665f41cc50a4dec9955efacc2596d68 Mon 2020-07-13 20:30:55 IST—Mon 2020-07-13 22:20:34 IST
  -2 c7d17407b0bd476a930af503f64b6006 Tue 2020-07-14 07:58:41 IST—Tue 2020-07-14 18:50:04 IST
  -1 7ab5e04518ec455abe0e2c86fdaa46fa Tue 2020-07-14 21:19:27 IST—Tue 2020-07-14 22:42:11 IST
   0 91856e86d4ee4e828717913deb288568 Wed 2020-07-15 08:11:51 IST—Wed 2020-07-15 17:14:10 IST

Para visualizar a sessão -2:

journalctl -b -2

Logs de uma unidade de serviço

journalctl -u service_name

Log de um intervalo de tempo

journalctl --since=yesterday --until=now
journalctl --since "2020-07-10"
journalctl --since "2020-07-10 15:10:00" --until "2020-07-12"
journalctl --since "-1h30min" (logs desse último intervalo)
journalctl --since "1 hour ago"

Logs baseado em UID, GID e PID

journalctl _PID=1234

Logs de apenas erros

journalctl -p 3 -xb

-p 3: filtra logs de prioridade 3, correspondente aos erros -x: evidencia informações adicionais quando disponíveis b: referente ao último boot

Ao invés do número, pode ser usada a string referente à prioridade do logs:

"emerg" (0), "alert" (1), "crit" (2), "err" (3), "warning" (4), "notice" (5), "info" (6), "debug" (7)

journalctl -p warning -b0

Checar uso de disco pelos logs

journalctl --disk-usage

Limpar logs

Arquivar os logs correntes e começar um novo:

journalctl --rotate

Deletar logs mais antigos:

journalctl --vacuum-time=2d

Restringir tamanho do log

journalctl --vacuum-size=100M

Restringir número de arquivos de log

journalctl --vacuum-files=5

Configuração para controle de espaço

Para não precisar intervir manualmente a todo momento que o log ocupar muito espaço, aqui vão alguns campos para alterar no arquivo /etc/systemd/journald.conf:

Para surtir efeito as novas configurações, reinicie o serviço:

systemctl restart systemd-journald

When the subject is monitoring, Zabbix is one of the first solutions that comes to mind. It is a Free and Open-Source solution that can be used everywhere. The current main release is version 5.0 LTS (long-term support). The main features are more integrations available, significant improvements in the security area, scalability and performance enhancement, more templates and plugins by the default.

What is Zabbix

Zabbix is one of the most famous solutions designed for real-time monitoring. It was created by Alexei Vladishev and currently is actively developed and supported by Zabbix SIA.

It is possible to collect metrics from devices, like servers, virtual machines and network devices. Dashboards can be constructed with a flexible alert system to simplify the decision-making. All Zabbix statistics, reports and configuration parameters, are found through a web-based front-end. This guarantees that the status of your network and the health of your servers can be reached from any place.

Getting Zabbix

As many other Open-Source software, the simple way to get Zabbix is by official RPM and DEB packages. In the download section you have an intuitive graphical way to choose version, operational system, database and web server.

Below this selection section, is shown all the commands to use on the terminal to install the properly chosen version. To use as an example, let's try the new release with Ubuntu 20.04, MySQL and Apache.

• 1 - Install Zabbix repository

# wget https://repo.zabbix.com/zabbix/5.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_5.0-1+focal_all.deb
# dpkg -i zabbix-release_5.0-1+focal_all.deb
# apt update

• 2 - Install Zabbix server, front-end, agent

# apt install zabbix-server-mysql zabbix-frontend-php zabbix-apache-conf zabbix-agent

• 3 - Create initial database

Run the following on your database host.

# mysql -uroot -p
password
mysql> create database zabbix character set utf8 collate utf8_bin;
mysql> create user zabbix@localhost identified by 'password';
mysql> grant all privileges on zabbix.* to zabbix@localhost;
mysql> quit;

On Zabbix server host import initial schema and data. You will be prompted to enter your newly created password.

# zcat /usr/share/doc/zabbix-server-mysql*/create.sql.gz | mysql -uzabbix -p zabbix

• 4 - Configure the database for Zabbix server

Edit file /etc/zabbix/zabbix_server.conf

DBPassword=password

• 5 - Configure PHP for Zabbix front-end

Edit file /etc/zabbix/apache.conf, uncomment and set the right timezone for you.

# php_value date.timezone America/Sao_Paulo

• 6 - Start Zabbix server and agent processes

Start Zabbix server and agent processes and make it start at system boot.

# systemctl restart zabbix-server zabbix-agent apache2
# systemctl enable zabbix-server zabbix-agent apache2

• 7 - Configure Zabbix front-end

By this point all the process to finish the installation is through a web browser.

Connect to your newly installed Zabbix front-end: http://server_ip_or_name/zabbix With this URL you should see the welcome screen:

Click on the Next step button to advance and verify the prerequisites of your installation.

On this next step enter the details for connecting to the database. Zabbix database must already be created.

Enter Zabbix server details.

Review a summary of settings.

Download the configuration file and place it under conf/ in the web server HTML documents subdirectory where you copied Zabbix PHP files to.

Finish the installation.

OTHER OPTIONS

Alternatively, you have some more great options to put Zabbix to work:

• Install from the containers;
• Download the virtual appliance;
• Cloud images
• Compile from source code;

Zabbix Requirements

For small solutions it's not necessary to reserve many resources, only 128 MB of memory and 256 MB on disk are enough. Obviously, this depends on the amount of host and parameters that are being monitored. If you're planning to keep a long history, this number on disk can reach Gigabytes. The same logic applies to the CPU load, it depends on the number of hosts. Zabbix documentation gives an example to illustrate the system based on hosts.

Supported Operating System

It's possible to use a variety of systems to install Zabbix. Not all systems support the complete resource solution, as shown in the next table:

Conclusion

If you work as a sysadmin, Zabbix is a must to on your top monitoring tools. Even for beginner, It's easy to take the first steps, learn the terminology and start to supervise any kind of IT infrastructure, service, application and resource.