CA Nimsoft Unified Reporter

Transcrição

1 CA Nimsoft Unified Reporter Guia de Início Rápido 7.0

2 Histórico de revisões do documento Versão do documento Data Alterações 1.2 Setembro de 2013 Revisões menores para o UR Maio de 2013 A seção Instalando a licença comercial do ireport foi adicionada 1.0 Abril de 2013 Versão inicial para disponibilidade geral do UR 6.5.

3 Avisos legais Copyright 2013, CA. Todos os direitos reservados. Garantia O material contido neste documento é fornecido "como está" e está sujeito a alterações em edições futuras sem aviso prévio. Além disso, na medida permitida pela lei aplicável, a Nimsoft LLC isenta-se de todas as garantias, sejam implícitas ou expressas, com relação a este manual e todas as informações contidas no presente documento, incluindo, sem limitação, garantias implícitas de comerciabilidade e adequação para um determinado fim. A Nimsoft LLC não será responsabilizada por erros ou danos acidentais ou resultantes do fornecimento, uso ou desempenho deste documento ou de qualquer outra informação contida no presente. Caso a Nimsoft LLC e o usuário tenham um acordo por escrito à parte sobre termos de garantia que cobrem o material deste documento conflitando com estes termos, os termos de garantia do acordo à parte prevalecerão. Licenças de tecnologia O hardware e/ou software descritos neste documento são fornecidos sob uma licença e poderão ser usados ou copiados somente de acordo com os termos da referida licença. Nenhuma parte deste manual poderá ser reproduzida de qualquer forma ou por qualquer meio (incluindo a recuperação e o armazenamento eletrônico ou a tradução em um idioma estrangeiro) sem um acordo prévio e consentimento por escrito da Nimsoft LLC, em conformidade com as leis de direitos autorais internacional e dos EUA. Legenda de direitos restritos Se o uso do software for destinado ao cumprimento de um contrato ou subcontrato do governo dos Estados Unidos da América -EUA, o software será fornecido e licenciado como "software comercial para computadores", conforme definido no DFAR (junho de 1995), ou como um "item comercial", conforme definido no FAR 2.101(a); ou como "software de computador restrito", conforme definido no FAR (junho de 1987) ou em qualquer regulamento equivalente do órgão ou Cláusula contratual. O uso, a duplicação ou a divulgação do software está sujeito aos termos de licença comercial padrão da Nimsoft LLC, os departamentos que não fazem parte do DOD (Department of Defense) e os órgãos do governo dos EUA não receberão mais Direitos do que os Direitos Restritos, conforme definido no FAR (c)(1-2) (junho de 1987). Os usuários do governo dos EUA não receberão mais que Direitos Limitados, conforme definido no FAR (junho de 1987) ou no DFAR (b)(2) (novembro de 1995), conforme aplicável em quaisquer dados técnicos. Marcas registradas Nimsoft é uma marca registrada da CA. Adobe, Acrobat, Acrobat Reader e Acrobat Exchange são marcas registradas da Adobe Systems Incorporated. Intel e Pentium são marcas registradas da Intel Corporation dos EUA. Java(TM) é uma marca registrada da Sun Microsystems, Inc. dos EUA. Microsoft e Windows são marcas registradas da Microsoft Corporation dos EUA. Netscape(TM) é uma marca registrada da Netscape Communications Corporation dos EUA. Oracle é uma marca registrada da Oracle Corporation, Redwood City, Califórnia, Estados Unidos. UNIX é uma marca registrada do Open Group. ITIL é uma marca comercial registrada do Office of Government Commerce no Reino Unido e em outros países. Todas as marcas comerciais, nomes comerciais, marcas de serviços e logotipos mencionados neste documento pertencem às respectivas empresas. Para obter informações sobre software de domínio público e licença, consulte a Licença de Terceiros e Termos de Uso do Nimsoft Monitor do documento no site:

4 Entre em contato com a CA Nimsoft Entrar em contato com a CA Support Para sua conveniência, a CA Technologies oferece um site onde é possível acessar as informações necessárias a seus produtos da CA Technologies para escritório doméstico, pequena empresa e corporativos. Em é possível acessar os seguintes recursos: Informações para contato online e telefônico, assistência técnica e atendimento ao cliente Informações sobre fóruns e comunidades de usuário Downloads de produto e documentação Políticas e diretrizes de CA Support Outros recursos úteis adequados ao seu produto Fornecendo comentários sobre a documentação do produto Enviar comentários ou perguntas sobre a documentação de produtos da Nimsoft da CA Technologies para ca.com. Se desejar fornecer comentários sobre a documentação geral dos produtos da CA Technologies, responda nossa breve pesquisa do cliente, disponível no site de CA Support, encontrado em

5 Índice Capítulo 1: Introdução 7 Obtendo o Unified Reporter... 8 Usuários e permissões... 8 Adicionar usuários ao NMS... 8 Estrutura de pastas... 9 Capítulo 2: Relatórios prontos 11 Opções para relatórios prontos Edição da lista de valores padrão Lista de relatórios prontos Capítulo 3: Criando uma exibição ad hoc 17 Capítulo 4: Instalando o ireport 19 Instalar o ireport Executadores de consulta Instalando a licença comercial do ireport Capítulo 5: Usando linguagens de consulta do Nimsoft personalizadas 25 Linguagem de consulta NimsoftJSONTopN Linguagem de consulta NimsoftJSONTimeSeries Índice 5

6

7 Capítulo 1: Introdução O Unified Reporter (UR) é um componente opcional que oferece relatórios avançados para o UMP (Unified Management Portal). O UR fornece os recursos a seguir: Criação de relatórios ad hoc de arrastar e soltar. Criação do painel arrastar e soltar, com atualização em tempo real e mashups de conteúdo externo. Gráficos incorporados que incluem gráficos de pizza, de barras, de linha, área de séries múltiplas e muitos outros tipos de gráfico. Uma biblioteca de relatórios pré-definidos que poupam tempo e esforço. Abstração de banco de dados usando extratores de consulta JSON. Geração de relatórios web parametrizados de autoatendimento. Programação, distribuição e versão histórica de relatórios. Acesso a qualquer origem de dados, inclusive o banco de dados SLM do Nimsoft. Além disso, o Unified Reporter fornece aos desenvolvedores e aos usuários avançados o seguinte: O criador de relatórios gráficos do ireport para a criação de relatórios mais complexos. A geração de relatórios de produção com pixel perfeito e prontos para impressão. Este documento fornece informações sobre o uso básico do UR e ireport. A documentação adicional do UR está disponível na ajuda com base na web do Unified Management Portal. Esta seção contém os seguintes tópicos: Obtendo o Unified Reporter (na página 8) Usuários e permissões (na página 8) Estrutura de pastas (na página 9) Capítulo 1: Introdução 7

8 Obtendo o Unified Reporter Obtendo o Unified Reporter O UR não requer licenciamento adicional para uso, mas ele não é instalado automaticamente com o UMP. Antes de instalar o UR, instale o UMP e depois obtenha o pacote de instalação do UR apropriado para o seu ambiente na página Downloads em support.nimsoft.com. Leia e compreenda as Notas da Versão do Unified Reporter e o Guia de Instalação do Unified Reporter, ambos disponíveis em docs.nimsoft.com, antes de instalar o UR. Após a instalação do UR, você poderá acessá-lo na página Relatórios no UMP ou adicioná-lo a uma página de sua escolha. Usuários e permissões Os usuários devem ter a permissão Relatórios unificados da ACL para acessar o UR. Os usuários do UR compõem dois tipos: os usuários de contato da conta e os usuários do NMS. Os usuários de contato da conta só podem ver a pasta Público > Nimsoft Monitor e a pasta à qual pertencem. Por padrão, os usuários de contato da conta têm acesso somente leitura ao repositório, a menos que tenham a permissão Administração do portal, o que concede a eles acesso total apenas à pasta de sua conta. Os usuários do NMS com a permissão Administração do portal podem ver as pastas de todas as contas e ter acesso total ao repositório. Adicionar usuários ao NMS Os usuários do UR (Unified Reporter) devem ser adicionados no NMS com o Gerenciador de infraestrutura. O aplicativo da web do UR (JasperReports Server Pro) fornece uma maneira de adicionar usuários. No entanto, a autenticação é controlada pelo NMS. Se você adicionar um usuário no UR e, em seguida, tentar efetuar logon com esse nome de usuário, ele não funcionará. Adicione o usuário no NMS usando o Gerenciador de infraestrutura e, em seguida, efetue logon no UR. 8 Guia de Início Rápido

9 Estrutura de pastas Estrutura de pastas Os relatórios prontos para uso do Nimsoft Monitor no repositório estão consolidados na pasta Público > Nimsoft Monitor. As pastas são criadas automaticamente para as contas quando os usuários de contato da conta efetuam logon pela primeira vez. Quando você atualiza de uma versão anterior ao UR 6.5, os relatórios prontos para uso são automaticamente colocados na pasta Público > Nimsoft Monitor e removidos do antigo local na estrutura de diretórios. Capítulo 1: Introdução 9

10

11 Capítulo 2: Relatórios prontos Esta seção fornece informações sobre os relatórios prontos incluídos com o UR. Esta seção contém os seguintes tópicos: Opções para relatórios prontos (na página 11) Lista de relatórios prontos (na página 12) Opções para relatórios prontos Quando você executa um relatório pronto do repositório, o painel Opções é exibido no lado esquerdo. O painel Opções permite personalizar o relatório ao selecionar entre os seguintes campos: Principais Permite definir o número de resultados como 5, 10 ou 25. Por padrão, esse valor é definido como 10. Período Permite que você defina como última hora, último dia, última semana, mês passado ou ano passado. Por padrão, esse valor é definido como último dia. Ignorar paginação Esta caixa de seleção permite visualizar um relatório inteiro em uma página rolando a tela para baixo, em vez de usar paginação no relatório. Esta opção pode ser útil para relatórios com uma quantidade considerável de dados ou se você pretende imprimir o relatório. Por padrão, a paginação fica ativada. Observação: com relatórios de dados de série temporal, como Taxa de emissões de CO2, o painel Opções exibe apenas o campo Período. Capítulo 2: Relatórios prontos 11

12 Lista de relatórios prontos Edição da lista de valores padrão Os usuários do NMS com a permissão Administração do portal da ACL podem editar os valores que são exibidos nas listas Principais e Período no painel Opções. Todos os relatórios prontos do Nimsoft Monitor herdam as opções nas listas Principais e Período. Portanto, quando você edita a lista de valores padrão, as alterações são aplicadas a todos os relatórios prontos do Nimsoft Monitor. Siga estas etapas: 1. Na exibição de repositório, expanda Público > Nimsoft Monitor> recursos > listas. 2. Selecione Período ou Principais e clique em Editar na barra de ferramentas. 3. No painel Editar lista de valores, adicione ou remova os valores na lista suspensa. Observação: os valores que você especificar para o Período deverão estar consistentes com o seu provedor de banco de dados. Lista de relatórios prontos A tabela a seguir lista os relatórios prontos fornecidos com o UR. Lista também as sondas que devem ser ativadas e as medições de qualidade do serviço que devem ser ativadas na sonda para obter dados para cada relatório. Categoria do relatório Nome do relatório QoS necessária Probe Applications Active Directory Replication Age QOS_AD_REPLICATION_AGE ad_response Applications End to End User Transactions QOS_E2E_EXECUTION e2e_appmon Applications Remedy Response Time QOS_REMEDY_RESPONSE remedy_response Applications/Ap ache Applications/Ap ache Applications/Ap ache Applications/Ap ache Applications/Ap ache Applications/Ap ache Apache Busy Workers QOS_APACHE_BUSYWORKERS apache Apache Bytes per Request QOS_APACHE_BYTESPERREQ apache Apache HTTP Response Time QOS_APACHE_HTTPRESTIME apache Apache Idle Workers QOS_APACHE_IDLEWORKERS apache Apache Requests Average Time QOS_APACHE_REQAVETIME apache Apache Requests Per Second QOS_APACHE_REQPERSEC apache 12 Guia de Início Rápido

13 Lista de relatórios prontos Databases/MyS QL Databases/Oracl e Databases/Oracl e Databases/Oracl e Databases/Oracl e Databases/SQL Server Databases/SQL Server Databases/SQL Server Databases/SQL Server MySQL % of Maximum Allowed Connections QOS_MYSQL_CONNECTION_USAGE_ RATE mysql Oracle % Table Space Free QOS_ORACLE_TABLESPACE_FREE oracle Oracle Databases by Size QOS_ORACLE_DATABASE_SIZE oracle Oracle SGA Memory Free QOS_ORACLE_SGA_MEMORY_FREE oracle Oracle Table Space Allocated Free QOS_ORACLE_TABLESPACE_ALLOC_F REE oracle SQL Server Free Allocated Space QOS_SQLSERVER_ALLOC_SPACE sql_server SQL Server Response Time QOS_SQL_RESPONSE sql_response SQL Server Transactions QOS_SQLSERVER_TRANSACTIONS sql_server SQL Server Users QOS_SQLSERVER_ACTIVE_USERS sql_server Network Tempo de resposta DHCP QOS_DHCP_RESPONSE dhcp_response Network Tempo de resposta DNS QOS_DNS_RESPONSE dns_response Network Hosts by Response Time QOS_NET_CONNECT net_connect Network Interfaces by Bandwidth Inbound QOS_INTERFACE_TRAFFIC_PERC interface_traffic Network Interfaces by Bandwidth Outbound QOS_INTERFACE_TRAFFIC_PERC interface_traffic Network Interfaces by Discards QOS_INTERFACE_DISCARDS interface_traffic Network Interfaces by Errors QOS_INTERFACE_ERRORS interface_traffic Network Interfaces by Queue Length QOS_INTERFACE_QLEN interface_traffic Network Tempo de resposta LDAP QOS_LDAP_RESPONSE_TIME ldap_response Network Tempo de resposta NTP QOS_NTP_RESPONSE_TIME ntp_response Network URLs by Response Time QOS_URL_RESPONSE url_response Network/Cisco Cisco by Memory Free QOS_MEMORY_USAGE cisco_monitor Network/Cisco Cisco by Memory Used QOS_MEMORY_USAGE cisco_monitor Network/Cisco Cisco CallManager CPU Usage QOS_CPU_USAGE ccm_monitor Network/Cisco Cisco CallManager Memory Used (%) QOS_CCM_PERFORMANCE ccm_monitor Capítulo 2: Relatórios prontos 13

14 Lista de relatórios prontos Network/Cisco Cisco CPU Usage QOS_CPU_USAGE cisco_monitor Network/Cisco Cisco QoS Drop Bitrate QOS_CISCO_DROP_BITRATE cisco_qos Network/Cisco Cisco QoS Post Policy Bitrate QOS_CISCO_POST_POLICY_BITRATE cisco_qos Network/Cisco Cisco QoS Post Policy Bytes QOS_CISCO_POST_POLICY_BYTE cisco_qos Network/Cisco Cisco QoS Pre Policy Bitrate QOS_CISCO_PRE_POLICY_BITRATE cisco_qos Servers Servers By CPU Usage QOS_CPU_USAGE cdm (local) ou rsp (remoto) Servers Servers by Disk Capacity QOS_DISK_USAGE_PERC cdm (local) ou rsp (remoto) Servers Servers by Physical Memory QOS_MEMORY_PHYSICAL_PERC cdm (local) ou rsp (remoto) Servers Servers/Process es Servers/Process es Servers/Process es Servers by Processor Queue Length QOS_PROC_QUEUE_LEN processes Processes by CPU Usage QOS_PROCESS_CPU processes Processes by Memory Usage QOS_PROCESS_MEMORY processes Processes by Thread Count QOS_PROCESS_THREADS processes ServiceDesk Accounts (NMS) by Events nsdgtw ServiceDesk ServiceDesk ServiceDesk Accounts (ServiceDesk) by Incidents Applications by Events and Incidents Devices by Mean Time to Repair vs Service Quality nsdgtw nsdgtw nsdgtw ServiceDesk Network Events and Incidents nsdgtw ServiceDesk Servers by Events and Incidents nsdgtw Virtualization/V Mware Virtualization/V Mware Virtualization/V Mware Virtualization/V Mware VMware Guests by CPU MHz QOS_CPU_USAGE_MHZ vmware VMware Guests by CPU Usage QOS_CPU_USAGE vmware VMware Hosts by CPU Usage QOS_CPU_USAGE vmware VMware Hosts by Disk Free QOS_DISK_FREE vmware 14 Guia de Início Rápido

15 Lista de relatórios prontos Virtualization/V Mware Virtualization/V Mware VMware Hosts by Memory Usage QOS_MEMORY_PERC_USAGE vmware VMware Hosts by VM Count QOS_COUNTER vmware Capítulo 2: Relatórios prontos 15

16

17 Capítulo 3: Criando uma exibição ad hoc Esta seção descreve como criar uma exibição ad hoc no Unified Reporter. Ao terminar de criar a exibição ad hoc, você pode salvá-la e abri-la como um relatório. Observação: além da permissão Unified Reporter da ACL necessária para acessar o UR, é necessário ter a permissão Administração do portal da ACL para criar um relatório. Siga estas etapas: 1. Efetue logon no UMP e vá para Unified Reporter. 2. Na página inicial, clique em Criar > Exibição ad hoc. O assistente de Seletor de dados é aberto. 3. No seletor de dados: a. Selecione Tópicos na parte superior do seletor de dados. b. Expanda a pasta Público e navegue até Componentes ad hoc > Tópicos > Tópico do Nimsoft Monitor. c. Selecione Tabela, Gráfico ou Tabela de referência cruzada nos tipos de exibição na parte inferior do Seletor de dados. A caixa de diálogo Controles de entrada é exibida. Observação: se a caixa de diálogo Controles de entrada não for exibida, clique no ícone Controles de entrada na barra de ferramentas Editor ad hoc. 4. A caixa de diálogo Controles de entrada é exibida. a. Especifique um período para a exibição ad hoc. b. Selecione os controles de entrada desejados a partir das listas de QoS, Origem e Destino. c. Clique em OK. 5. Arraste e solte ou clique duas vezes em campos e medidas para adicioná-los à exibição ad hoc. Capítulo 3: Criando uma exibição ad hoc 17

18 Lista de relatórios prontos 6. Clique no ícone Salvar quando estiver satisfeito com a exibição ad hoc. a. Insira um nome para o relatório. b. Vá até um local no repositório e clique em Salvar. A exibição ad hoc e os relatórios correspondentes agora aparecem no repositório. É possível executar o relatório, ou editar a exibição ad hoc. 18 Guia de Início Rápido

19 Capítulo 4: Instalando o ireport Depois de instalar o Unified Reporter (UR), use as seguintes etapas nesta seção para configurar o ireport. É possível instalar o ireport em qualquer sistema com acesso de rede no sistema ao qual você instalou o UR. Observação: o aplicativo ireport deve ser configurado corretamente para que seja possível modificar, copiar ou executar relatórios que usam uma linguagem de executor de consulta. É possível exibir os relatórios prontos no Unified Reporter, mas não é possível editar ou copiar os relatórios prontos sem o ireport. Esta seção contém os seguintes tópicos: Instalar o ireport (na página 19) Executadores de consulta (na página 22) Instalando a licença comercial do ireport (na página 23) Instalar o ireport Siga estas etapas: 1. Baixe a versão apropriada do ireport na página Downloads em support.nimsoft.com. 2. Instale o ireport em um computador com acesso de rede ao sistema no qual você instalou o UR. 3. Obtenha bibliotecas a partir da implantação do UR: a. Digite o seguinte URL no navegador: b. Salve o arquivo.jar em um local de sua escolha. c. Inicie o ireport. d. Adicione os arquivos JAR ao caminho de classe do ireport: Na barra de menus do ireport, selecione Ferramentas > Opções > Caminho de classe. Clique em Adicionar JAR e vá até o local onde você salvou o arquivo JAR. Clique em Abrir. 4. Adicione executores de consulta: a. Na barra de menus do ireport, selecione Ferramentas > Opções > Executores de consulta. b. Adicione executores de consulta (na página 22). Capítulo 4: Instalando o ireport 19

20 Instalar o ireport 5. Conecte o ireport ao seu servidor do UMP: a. Na barra de menus do ireport, clique em Janela > Repositório do servidor do JasperReports. O painel Navegador do repositório é aberta. b. Clique no ícone Adicionar novo servidor para se conectar à instância do UR Server. A caixa de diálogo Plugin do JasperServer é aberta. c. No campo ID, forneça um nome para o servidor do UMP. Por exemplo, digite Unified Reporter. d. No campo URL do JasperReports Server, edite localhost: 8080 para que aponte para o seu servidor do UMP. e. Forneça um nome de usuário e senha válidos do Nimsoft. 6. Configure a origem de dados: a. Clique no ícone Banco de dados de relatórios. A caixa de diálogo Conexões > Origens de dados é aberta. b. Selecione Novo > conexão Database JDBC. Clique em Avançar. A caixa de diálogo Conexão JDBC do banco de dados é exibida. c. Forneça um nome, como NIS, para a conexão JDBC do banco de dados. 20 Guia de Início Rápido

21 Instalar o ireport d. Clique no menu suspenso do campo Driver JDBC e selecione o driver JDBC adequado para o banco de dados. O campo URL do JDBC é atualizado e exibe um modelo de UR para o driver JDBC específico que você selecionou. Por exemplo, se você selecionou MS SQL Server (2005) (com.microsoft.sqlserver.jdbc.sqlserverdriver), o campo URL do JDBC exibe jdbc:sqlserver://localhost:1433;databasename=databasename. Observação: os drivers JDBC que estão disponíveis são mostrados em fonte preta; os drivers JDBC que não estão disponíveis são mostrados em fonte vermelha. Se o driver JDBC adequado não estiver disponível, verifique se você adicionou os arquivo JAR ao caminho de classe, conforme descrito na etapa 3. e. No campo URL do JDBC, digite o endereço IP (ou nome do host) do servidor de banco de dados e o nome do banco de dados. Por exemplo, se você selecionou MS SQLServer (2005) (com.microsoft.sqlserver.jdbc.sqlserverdriver), digite jdbc:sqlserver://<endereço_ip>:1433;databasename=<nimsoftslm>. Observação: na maioria dos casos, a conexão JDBC usa as mesmas informações que o data_engine a configuração do banco de dados. f. Forneça um nome de usuário e uma senha. Capítulo 4: Instalando o ireport 21

22 Executadores de consulta g. Clique no botão Testar. Se a conexão for bem-sucedida, clique em Salvar. Se a conexão não foi bem-sucedida, verifique os seguintes itens: Você selecionou um driver JDBC adequado para o banco de dados. Você forneceu informações válidas no campo URL JDBC e credenciais válidas. O sistema no qual você instalou o ireport tenha acesso de rede para o banco de dados. O ireport agora está instalado e você pode começar a usá-lo para modificar, copiar ou executar relatórios. Executadores de consulta A tabela a seguir lista os executadores de consulta do Nimsoft que se pode adicionar ao ireport. Linguagem Query Executer Factory Fields Provider Class NimsoftJSONTopN NimsoftJSONTimeSe ries com.nimsoft.ur.jrs.executer.nimsoftjsontop NFactory com.nimsoft.ur.jrs.executer.nimsoftjsontim eseriesfactory com.nimsoft.ur.ireport.fieldsprovider.nims oftjsontopnfp com.nimsoft.ur.ireport.fieldsprovider.nims oftjsontimeseriesfp nimsoft com.nimsoft.ur.jrs.executer.nimsoftfactory com.nimsoft.ur.ireport.fieldsprovider.nims oftfp ServiceDesk ServiceDeskNMS com.nimsoft.ur.jrs.executer.servicedeskfact ory com.nimsoft.ur.jrs.executer.servicedesknms Factory com.nimsoft.ur.ireport.fieldsprovider.servic edeskfp com.nimsoft.ur.ireport.fieldsprovider.servic edesknmsfp NMS com.nimsoft.ur.jrs.executer.nmsfactory com.nimsoft.ur.ireport.fieldsprovider.nmsf P 22 Guia de Início Rápido

23 Instalando a licença comercial do ireport Instalando a licença comercial do ireport Inicialmente, o ireport usa uma licença de avaliação que fornece funcionalidade de licença comercial por 30 dias após a instalação. O ireport ainda pode ser usado após a expiração da licença de avaliação, contudo, alguns recursos não estarão mais disponíveis. Você pode instalar a licença comercial fornecida com os arquivos de instalação do UR para continuar usando todos os recursos do ireport comercial. Siga estas etapas: 1. Abra o ireport. 2. Selecione Ajuda > Gerenciador de licenças na barra de ferramentas. 3. Clique em Install License e vá até o arquivo de licença em <pasta_da_instalação_do_nimsoft>\probes\service\wasp\conf\jasperserver.license. Capítulo 4: Instalando o ireport 23

24

25 Capítulo 5: Usando linguagens de consulta do Nimsoft personalizadas Os relatórios prontos instalados com o UR usam as linguagens da consulta personalizada NimsoftJSONTopN e NimsoftJSONTimeSeries, instalados no aplicativo web do Unified Reporter. Esta seção fornece informações sobre como usar as linguagens de consulta NimsoftJSONTopN e consulta NimsoftJSONTimeSeries. Observação: o aplicativo ireport deve ser configurado corretamente para que você possa modificar, copiar ou executar relatórios usando uma linguagem de consulta do Nimsoft personalizada. Consulte a seção Configurando o ireport (na página 19). Esta seção contém os seguintes tópicos: Linguagem de consulta NimsoftJSONTopN (na página 25) Linguagem de consulta NimsoftJSONTimeSeries (na página 27) Linguagem de consulta NimsoftJSONTopN Esta seção fornece informações sobre como usar a linguagem de consulta NimsoftJSONTopN. A linguagem NimsoftJSONTopN espera uma representação de sequência de caracteres de um objeto JSON. Além disso: O objeto JSON deve conter um objeto topnreportdefinition. O objeto topnreportdefinition deve conter a chave qos, cujo valor é uma sequência de caracteres da métrica de qualidade do serviço para o relatório desejado. Por exemplo, a sintaxe a seguir relatará o valor médio de QOS_MEMORY_PHYSICAL_PERC para cada origem que estiver coletando esses dados nas últimas 24 horas. Exemplo 1 de NimsoftJSONTopN {"topnreportdefinition": { "qos":"qos_memory_physical_perc" } } Capítulo 5: Usando linguagens de consulta do Nimsoft personalizadas 25

26 Linguagem de consulta NimsoftJSONTopN No próximo exemplo, a sintaxe a seguir relatará os cinco principais valores e os valores médio, mínimo e máximo de QOS_PROCESS_CPU nos últimos 30 minutos na máquina cadev.dev.fco. Exemplo 2 de NimsoftJSONTopN {"topnreportdefinition": { "numberofbars":5, "statistics":["avg", "max", "min"], "qos":"qos_process_cpu", "source":"cadev.dev.fco", "period":30, "periodunits":"minute", "groupfirstby": "target" } } Consulte a tabela abaixo para obter valores opcionais adicionais que você pode fornecer no objeto topnreportdefinition para definir ainda mais o relatório. Chave Description Tipo de dados de valor statistics numberofbars source target period periodunits Defina as estatísticas a serem coletadas para o relatório. Opções: avg, min, max Restringe o relatório ao número x de principais resultados Restringe o relatório a uma origem específica Restringe o relatório a um destino específico. Também pode ser um token especial "{source}" para corresponder onde target=source Restringe o relatório a uma determinada duração de intervalo Define as unidades para o período. Opções: minute, hour, day, month JSONArray Integer Sequência de caracteres Sequência de caracteres Número longo Sequência de caracteres groupfirstby Pode ser origem ou destino Sequência de caracteres Valor padrão "statistics":["avg"] "numberofbars":10 Corresponde a qualquer origem Corresponde a qualquer destino "period":24 "periodunits":"hour" "groupfirstby":"source" 26 Guia de Início Rápido

27 Linguagem de consulta NimsoftJSONTimeSeries Linguagem de consulta NimsoftJSONTimeSeries Esta seção fornece informações sobre como usar a linguagem de consulta NimsoftJSONTimeSeries. A linguagem NimsoftJSONTimeSeries espera uma representação de sequência de caracteres de um objeto JSON. Além disso: O objeto JSON deve conter um objeto timeseriesreportdefinition. O objeto timeseriesreportdefinition deve conter a chave qos, cujo valor é uma sequência de caracteres da métrica de qualidade do serviço para o relatório desejado. Por exemplo, a sintaxe a seguir relatará o valor médio de QOS_MEMORY_PHYSICAL_PERC para cada origem que estiver coletando esses dados nas últimas 24 horas. Exemplo 1 de NimsoftJSONTimeSeries {"timeseriesreportdefinition": { "qos":"qos_memory_physical_perc" } } Consulte a tabela abaixo para obter valores opcionais adicionais que você pode fornecer no objeto timeseriesreportdefinition para definir ainda mais o relatório. Chave Description Tipo de dados de valor Valor padrão origem destino period periodunits Restringe o relatório a uma origem específica Restringe o relatório a um destino específico. Também pode ser um token especial "{source}" para corresponder onde target=source Restringe o relatório a uma determinada duração de intervalo Define as unidades para o período. ["minute", "hour", "day", "month"] Sequência de caracteres Sequência de caracteres Número longo Sequência de caracteres Corresponde a qualquer origem Corresponde a qualquer destino "period":24 "periodunits":"hour" Capítulo 5: Usando linguagens de consulta do Nimsoft personalizadas 27

28 Linguagem de consulta NimsoftJSONTimeSeries measurementscale Dimensiona os valores de medição retornados por este valor Duplo "measurementscale":1 measurementoffset Desloca os valores de medição retornados por este valor Duplo "measurementoffset":0 percentileline Fornece uma linha de percentual horizontal calculada no momento em que o relatório é executado [true, false] Booleano "percentileline":false percentilevalue O valor para a linha de percentual [0-100]. Duplo "percentilevalue": Guia de Início Rápido