Gerando relatórios de um banco de dados

Você pode usar consultas a bancos de dados para gerar relatórios contendo as informações de eventos desejadas. As seções a seguir descrevem as tabelas e campos do banco de dados usados para armazenar informações de eventos e fornecem exemplos de consultas SQL que você pode usar:


Tabelas e campos do banco de dados

O banco de dados inclui as três tabelas a seguir:

Cada tabela do banco de dados contém até 17 campos de informações. A tabela a seguir lista os campos e as tabelas do banco de dados que incluem os campos. O tipo de dado em todos os campos é varchar(256).

Campo Tabelas Descrição

zenEventType

T_Success
T_Failure
T_Info

O evento que ocorreu.

  • Os tipos de evento com êxito (T_Success) são:

    Disparo Bem-Sucedido
    Distribuição Bem-Sucedida
    Êxito ao Desinstalar
    Êxito no Cache
    Processo Encerrado

  • Os tipos de evento com falha (T_Failure) são:

    Falha do Disparo
    Falha ao Distribuir
    Falha ao Desinstalar
    Falha no Cache
    Ocultar Filtro
    Mostrar Filtro

  • Os tipos de eventos de gerenciamento de processos externos (rogue) (T_Info) são:

    Processo Encerrado
    Processo Ignorado

zenDateTime

T_Success
T_Failure
T_Info

A data e o horário em que o evento ocorreu.

zenUserTDN

T_Success
T_Failure
T_Info

O nome exclusivo e árvore do usuário para o qual o evento ocorreu.

zenWSTDN

T_Success
T_Failure
T_Info

O nome exclusivo e árvore da estação de trabalho em que o evento ocorreu. Se a estação de trabalho não foi importada para o eDirectory como um objeto Estação de Trabalho, o campo contém ESTAÇÃO DE TRABALHO NÃO REGISTRADA.

zenWSAddr

T_Success
T_Failure
T_Info

O endereço IPXTM ou IP da estação de trabalho em que o evento ocorreu.

zenAppTDN

T_Success
T_Failure
T_Info

O nome exclusivo e árvore do objeto Aplicativo para o qual o evento ocorreu.

Como os processos externos (rogue) não possuem um objeto Aplicativo, este campo será sempre "ZEN Process Management" na tabela T_Info.

zenAppGUID

T_Success
T_Failure
T_Info

O identificador global exclusivo (GUID) atribuído ao objeto Aplicativo. O GUID está localizado na página Opções do objeto Aplicativo (guia Opções de Distribuição).

Como os processos externos (rogue) não possuem um objeto Aplicativo, este campo estará sempre vazio na tabela T_Info.

zenAppVer

T_Success
T_Failure
T_Info

O número da versão atribuído ao objeto Aplicativo. Os números possíveis variam de 0 a 65535. O número da versão está localizado na página Opções do objeto Aplicativo (guia Opções de Distribuição).

Como os processos externos (rogue) não possuem um objeto Aplicativo, este campo estará sempre vazio na tabela T_Info.

zenMajor

T_Success
T_Failure
T_Info

Para eventos com êxito (tabela T_Success), este campo é sempre 0.

Para eventos com falha (tabela T_Failure), este campo lista o código de erro gerado pelo Disparador de Aplicativos.

Para eventos de processos externos (rogue) (tabela T_Info), este campo fica em branco.

zenMinor

T_Success
T_Failure
T_Info

Para eventos com êxito (tabela T_Success), este campo é sempre 0.

Para eventos com falha (tabela T_Failure), este campo lista informações adicionais sobre o código de erro.

Para eventos de processos externos (rogue) (tabela T_Info), este campo fica em branco.

zenEventString1

T_Failure
T_Info

Para eventos com falha (tabela T_Failure), este campo pode relacionar informações adicionais descrevendo a razão da falha.

Para eventos de processos externos (rogue) (tabela T_Info), este campo lista o caminho do executável para o processo externo (rogue).

zenEventString2

T_Failure
T_Info

Para eventos com falha (tabela T_Failure), este campo pode relacionar informações adicionais descrevendo a razão da falha.

Para eventos de processos externos (rogue) (tabela T_Info), este campo relaciona o nome do arquivo original do processo.

zenEventString3

T_Failure
T_Info

Para eventos com falha (tabela T_Failure), este campo pode relacionar informações adicionais descrevendo a razão da falha.

Para eventos de processos externos (rogue) (tabela T_Info), este campo contém o ID do processo (PID).

zenEventString4

T_Failure
T_Info

Para eventos com falha (tabela T_Failure), este campo pode relacionar informações adicionais descrevendo a razão da falha.

Para eventos de processos externos (rogue) (tabela T_Info), este campo contém o ID do processo pai (PID pai).

zenEventString5

T_Failure
T_Info

Para eventos com falha (tabela T_Failure), este campo pode relacionar informações adicionais descrevendo a razão da falha.

Para eventos de processos externos (rogue), este campo contém a ação do evento, que pode ser "processo ignorado" ou "processo encerrado com êxito".

zenAppFlags

T_Success
T_Failure
T_Info

Para eventos com êxito (tabela T_Success) e eventos com falha (tabela T_Failure), este campo relaciona a máscara de bits do objeto Aplicativo.

Para eventos de processos externos (rogue) (tabela T_Info), este campo é sempre 0.


Consultas personalizadas

Você pode criar consultas personalizadas ao banco de dados para procurar informações específicas. Seguem-se exemplos de consultas SQL que você pode usar.


Todos os Campos para um Evento

As consultas seguintes retornam todos os campos de informações para um evento com êxito, com falha ou de gerenciamento de processos externos (rogue) armazenado no banco de dados. Os eventos serão classificados na ordem em que foram inseridos no banco de dados.

SELECT * FROM T_SUCCESS

SELECT * FROM T_FAILURE

SELECT * FROM T_INFO


Todos os Campos para um Evento, Classificados por um Campo Específico

Para classificar a lista por um campo específico, adicione ORDER BY nome_do_campo, como nos seguintes exemplos:

SELECT * FROM T_SUCCESS ORDER BY zenWSTDN

SELECT * FROM T_FAILURE ORDER BY zenAppTDN

SELECT * FROM T_INFO ORDER BY zenUserTDN


Todos os Campos para Tipos de Eventos Específicos

Para incluir apenas um tipo do evento específico (disparar, distribuir, etc.) para um evento (com êxito, com falha, etc.), adicione WHERE zenEventType="tipo_de_evento", como nos seguintes exemplos:

SELECT * FROM T_SUCCESS WHERE zenEventType="Launch Success"

SELECT * FROM T_FAILURE WHERE zenEventType="Launch Failure"

SELECT * FROM T_INFO WHERE zenEventType="Process Terminated"

Os tipos de eventos válidos são relacionados na tabela em


Campos Específicos para um Evento

Para incluir apenas campos específicos, substitua o * por uma lista de campos delimitados por vírgula, como no seguinte exemplo:

SELECT zenEventType,zenDateTime,zenUserTDN,zenAppTDN FROM T_SUCCESS WHERE zenEventType="Cache Success" ORDER BY zenUserTDN


Consultas predefinidas

As versões anteriores do Gerenciamento de Aplicativos do ZENworks for Desktops incluem consultas predefinidas. Elas não estão incluídas nesta versão do ZfD. Para continuar usando essas consultas, use as informações da tabela seguinte para criar as consultas na ferramenta de consultas de seu banco de dados.

Consulta Explicação

SELECT * FROM T_SUCCESS ORDER BY zenWSTDN

Gera um relatório mostrando quaisquer eventos com êxito, com os eventos agrupados por estação de trabalho.

SELECT * FROM T_SUCCESS ORDER BY zenUserTDN

Gera um relatório mostrando quaisquer eventos com êxito, com os eventos agrupados por usuário.

SELECT * FROM T_SUCCESS ORDER BY zenAppTDN

Gera um relatório mostrando quaisquer eventos com êxito, com os eventos agrupados por aplicativo.

SELECT * FROM T_FAILURE ORDER BY zenWSTDN

Gera um relatório mostrando quaisquer eventos com falha, com os eventos agrupados por estação de trabalho.

SELECT * FROM T_FAILURE ORDER BY zenUserTDN

Gera um relatório mostrando quaisquer eventos com falha, com os eventos agrupados por usuário.

SELECT * FROM T_FAILURE ORDER BY zenAppTDN

Gera um relatório mostrando quaisquer eventos com falha, com os eventos agrupados por aplicativos.