---
sourceDocument: Yokohama Gestão de serviços de TI
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/it-service-management

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Gestão de serviços de TI

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# DEX verifica as definições para Mac

# DEX verifica as definições para Mac {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 min. de leitura

As definições de verificação para Mac são conjuntos predeterminados de regras e critérios que avaliam o desempenho, a segurança e a conformidade dos dispositivos Mac. Essas verificações podem abranger vários aspectos, como uso de CPU, uso de memória, detalhes da bateria e status do firewall.
Para sistemas macOS systems, para recuperar a totalidade dos dados, inclua conteúdos subsequentes em /etc/sudoers.  
Para o Agent versão 3.4.0 ou mais antiga:

    _servicenow ALL=NOPASSWD: SETENV: /Library/Caches/servicenow/agent-client-collector/osquery/bin/osqueryi *, /usr/bin/mdls, /usr/bin/log, /bin/kill, /bin/launchctl
    Defaults:_servicenow !requiretty

Para o Agent versão 3.4.1 ou mais recente:

    _servicenow ALL=NOPASSWD: SETENV: /Library/Application\ Support/servicenow/agent-client-collector/cache/osquery/bin/osqueryi *, /usr/bin/mdls, /usr/bin/log, /bin/kill, /bin/launchctl
     Defaults:_servicenow !requiretty

Nota:  
É possível configurar as definições de verificação e os dados recuperáveis associados. Algumas das definições de verificação listadas podem recuperar dados que contêm ou são considerados informações pessoais.  
Para garantir a configuração adequada do sudo, é preferível remover o arquivo a seguir

    /private/etc/sudoers.d/_servicenow

## Verificar definições --- Aplicação (métricas) {#dex-check-definitions-mac__section_q2d_wmd_hwb}

DEX oferece as seguintes definições de verificação que podem ser acessadas somente quando a aplicação está em execução, exceto pelas definições de verificação os.mac.check-app-version, os.mac.check-app-is-installed, os.mac.check-app-last-access-time e os.mac.check-app-last-updated, que podem ser acessadas mesmo quando a aplicação não está em execução. Nos parâmetros de definição de verificação:

* appName = nome da aplicação. Por exemplo, Webex.
* appSysId= sys id da aplicação.
* primaryProcess = lista dos processos principais da aplicação separados por uma barra vertical ( \| ). O primeiro processo que existe no dispositivo de endpoint tem prioridade. Exemplo 1: Webex.app. Exemplo 2: Microsoft Teams.app \| Microsoft Teams Classic.app.  
  Nota:  
  Se o processo primário da aplicação Teams for Microsoft Teams.app em um dispositivo de endpoint, e em outro dispositivo de endpoint for Microsoft Teams classic.app, ao determinar a prioridade com base na disponibilidade do processo no dispositivo de endpoint, o processo que está presente no dispositivo de endpoint primeiro tem precedência.
* secondaryProcesses = lista de processos secundários da aplicação separados por uma barra vertical ( \| ). Exemplo: Cisco WebEx Start.app \| webexmtaV2.app.

{#dex-check-definitions-mac__ul_phl_4zd_2xb}{#dex-check-definitions-mac__table_yxf_q4d_hwb__entry__3}

| Verificar nome da definição | Verificar os parâmetros de definição | Descrição |
|-|-|-|
| os.mac.check-app-cpu-usage | * --appName=\<nome da aplicação\> * --primaryProcess=\<nome do processo primário\> * --secondaryProcesses=\<lista de processos secundários separados por uma barra vertical\> * --appSysId=\<sys id da aplicação\> {#dex-check-definitions-mac__ul_cnw_yrj_swb} | Verifica a quantidade de recursos da CPU que estão sendo usados pela aplicação. |
| os.mac.check-app-memory-usage | * --appName=\<nome da aplicação\> * --primaryProcess=\<nome do processo primário\> * --secondaryProcesses=\<lista de processos secundários separados por uma barra vertical\> * --appSysId=\<sys id da aplicação\> {#dex-check-definitions-mac__ul_eg2_kvc_xwb} | Verifica a quantidade de recursos da memória que estão sendo usados pela aplicação. |
| os.mac.check-app-listening-ports | * --appName=\<nome da aplicação\> * --primaryProcess=\<nome do processo primário\> * --secondaryProcesses=\<lista de processos secundários separados por uma barra vertical\> * --appSysId=\<sys id da aplicação\> {#dex-check-definitions-mac__ul_vwz_mvc_xwb} | Recupera os números de porta que estão abertas e pelas quais o tráfego de rede de entrada pode chegar à aplicação. |
| os.mac.check-app-last-updated | * --appName=\<nome da aplicação\> * --primaryProcess=\<nome do processo primário\> * --secondaryProcesses=\<lista de processos secundários separados por uma barra vertical\> * --appSysId=\<sys id da aplicação\> {#dex-check-definitions-mac__ul_jd2_nvc_xwb} | Verifica a hora e a data da instalação da atualização mais recente da aplicação. Nota: Esta definição de verificação não requer que a aplicação esteja em um estado em execução. |
| os.mac.check-app-version | * --appName=\<nome da aplicação\> * --primaryProcess=\<nome do processo primário\> * --secondaryProcesses=\<lista de processos secundários separados por uma barra vertical\> * --appSysId=\<sys id da aplicação\> {#dex-check-definitions-mac__ul_y1t_pvc_xwb} | Recupera o número da versão da aplicação. Nota: * Esta definição de verificação não requer que a aplicação esteja em um estado em execução. * Se uma aplicação não tiver uma versão, a definição de verificação retornará a cadeia de caracteres "sem versões" para essa aplicação. {#dex-check-definitions-mac__ul_wts_jvb_zzb} |
| os.mac.check-app-is-installed | * --appName=\<nome da aplicação\> * --primaryProcess=\<nome do processo primário\> * --secondaryProcesses=\<lista de processos secundários separados por uma barra vertical\> * --appSysId=\<sys id da aplicação\> {#dex-check-definitions-mac__ul_ysn_nvc_xwb} | Verifica se a aplicação está instalada ou não no dispositivo. Nota: Esta definição de verificação não requer que a aplicação esteja em um estado em execução. |
| os.mac.check-app-is-running | * --appName=\<nome da aplicação\> * --primaryProcess=\<nome do processo primário\> * --secondaryProcesses=\<lista de processos secundários separados por uma barra vertical\> * --appSysId=\<sys id da aplicação\> {#dex-check-definitions-mac__ul_ynr_nvc_xwb} | Verifica se a aplicação está em um estado em execução ou não. |
| os.mac.check-app-uptime | * --appName=\<nome da aplicação\> * --primaryProcess=\<nome do processo primário\> * --secondaryProcesses=\<lista de processos secundários separados por uma barra vertical\> * --appSysId=\<sys id da aplicação\> {#dex-check-definitions-mac__ul_ajx_dvd_2zb} | Verifica o tempo de atividade da aplicação fornecida. |
| os.mac.check-app-last-access-time | * --appName=\<nome da aplicação\> * --primaryProcess=\<nome do processo primário\> * --secondaryProcesses=\<lista de processos secundários separados por uma barra vertical\> * --appSysId=\<sys id da aplicação\> {#dex-check-definitions-mac__ul_bvx_mx4_pzb} | Verifica a hora mais recente em que a aplicação foi executada ou executada. Nota: * Esta definição de verificação não requer que a aplicação esteja em um estado em execução. * Se a aplicação não tiver sido executada pelo usuário nos últimos 7 dias, a hora do último acesso ficará em branco. {#dex-check-definitions-mac__ul_cvx_mx4_pzb} |
| os.mac.check-app-io-usage-read | * --appName=\<nome da aplicação\> * --primaryProcess=\<nome do processo primário\> * --secondaryProcesses=\<lista de processos secundários separados por uma barra vertical\> * --appSysId=\<sys id da aplicação\> {#dex-check-definitions-mac__ul_g34_lvc_xwb} | Verifica o uso pela aplicação de operações de E/S de leitura (entrada/saída). |
| os.mac.check-app-io-usage-write | * --appName=\<nome da aplicação\> * --primaryProcess=\<nome do processo primário\> * --secondaryProcesses=\<lista de processos secundários separados por uma barra vertical\> * --appSysId=\<sys id da aplicação\> {#dex-check-definitions-mac__ul_ths_mvc_xwb} | Verifica o uso pela aplicação de operações de E/S de escrita (entrada/saída). |
| os.mac.check-app-domain-network-latency | * --appName=\<nome da aplicação\> * --primaryProcess=\<nome do processo primário\> * --secondaryProcesses=\<lista de processos secundários separados por uma barra vertical\> * --appSysId=\<sys id da aplicação\> * --domain=\<domínio da aplicação\> {#dex-check-definitions-mac__ul_ots_spg_12c} | Busca a latência da rede do domínio da aplicação. |
| os.mac.check-app-crashes | * --appName=\<nome da aplicação\> * --primaryProcess=\<nome do processo primário\> * --secondaryProcesses=\<lista de processos secundários separados por uma barra vertical\> * --appSysId=\<sys id da aplicação\> {#dex-check-definitions-mac__ul_djt_514_cbc} | Busca o número de falhas e detalhes de falhas da aplicação. |
[ ]

{#dex-check-definitions-mac__table_yxf_q4d_hwb}

## Verificar definições --- Dispositivo (Métricas) {#dex-check-definitions-mac__section_dj3_2gl_qwb}

DEX oferece os seguintes tipos de definições de verificação para o dispositivo.{#dex-check-definitions-mac__table_wtg_ydq_rwb__entry__2}

| Verificar nome da definição | Descrição |
|-|-|
| os.mac.check-system-cpu-usage | Verifica a utilização da CPU. |
| os.mac.check-system-cpu-details | Recupera o nome da CPU, o número de núcleos físicos e lógicos e as informações da arquitetura. |
| os.mac.check-system-memory-usage | Verifica a utilização da memória do sistema. |
| os.mac.check-system-last-access-time | Verifica a última vez em que o dispositivo atual foi acessado. Nota: Esta definição de verificação funciona em dispositivos bloqueados e desbloqueados. |
| os.mac.check-system-uptime | Verifica a quantidade de tempo decorrido desde a última inicialização do sistema. |
| os.mac.check-system-time | Verifica o horário atual no Tempo Universal Coordenado (UTC) usando o registro de data e hora do Unix. |
| os.mac.check-system-device-crashes | Recupera detalhes de diferentes falhas no seu dispositivo. Nota: Esta verificação busca panics do kernel presentes nos logs do dispositivo nos últimos cinco minutos. |
| os.mac.check-system-device-details | Recupera o tipo, o modelo e o número de série do chassi. |
| os.mac.check-system-device-events | Recupera os detalhes de eventos que ocorreram no dispositivo durante o intervalo de tempo especificado. Os eventos para Mac incluem: última inicialização, usuários conectados, software instalado, software atualizado, usuários adicionados e redefinição de senhas. |
| os.mac.check-system-disk-details | Recupera detalhes do disco, como espaço total, espaço usado e espaço livre em bytes. |
| os.mac.check-system-disk-io-usage-read | Recupera bytes de disco lidos por segundo. |
| os.mac.check-system-disk-io-usage-write | Recupera bytes de disco escritos por segundo. |
| os.mac.check-system-disk-usage | Recupera o espaço usado em disco como uma porcentagem do espaço total. |
| os.mac.check-system-os-details | Recupera o nome, versão, plataforma, arquitetura e data de instalação do sistema operacional. |
| os.mac.check-system-net-bytes-incoming | Recupera os bytes de rede de entrada por segundo em todos os dispositivos de rede. |
| os.mac.check-system-net-bytes-outgoing | Recupera os bytes de rede de saída por segundo em todos os dispositivos de rede. |
| os.mac.check-system-logged-in-users | Recupera os detalhes dos usuários conectados ao dispositivo. |
| os.mac.check-system-session-details | Recupera o tempo de sessão dos usuários conectados no momento em minutos. |
| os.mac.check-system-network-details | Recupera os detalhes da rede, incluindo Ethernet, Wi-Fi e outras informações relevantes. |
| os.mac.check-system-battery-details | Recupera dados relacionados à bateria, incluindo a porcentagem restante da bateria, a voltagem projetada, o tempo de execução estimado e a capacidade máxima da bateria. Nota: * Esta definição de verificação não se aplica a máquinas virtuais (VMs) ou desktops, porque eles não têm baterias. * Se a capacidade atual for superior à capacidade projetada, a bateria será arredondada para 100%. {#dex-check-definitions-mac__ul_i55_tmb_fdc} |
| os.mac.check-system-battery-charge-percentage | Recupera a porcentagem de carga das baterias presentes no dispositivo. Nota: * Esta definição de verificação não se aplica a máquinas virtuais (VMs) ou desktops, porque eles não têm baterias. * Se a capacidade atual for superior à capacidade projetada, a bateria será arredondada para 100%. {#dex-check-definitions-mac__ul_cxv_15b_fdc} |
| os.mac.check-system-firewall-enabled | Verifica se o firewall do sistema operacional está ativo e habilitado. |
| os.mac.check-system-pending-updates | Verifica o status das atualizações de software pendentes. |
| os.mac.check-system-admin-users | Recupera todas as contas de usuário com privilégios administrativos locais. |
| os.mac.check-system-reboot-details | Recupera os detalhes da reinicialização do dispositivo. |
| os.mac.check-system-os-setup-details | Recupera a idade aproximada do SO do dispositivo. |
| os.mac.check-system-compliance-details | Recupera os detalhes de conformidade do sistema. Isso inclui a lista de todos os valores de métricas e apps configurados que não estão em conformidade e calcula uma classificação de conformidade com base nisso. Nota: * Esta definição de verificação fornece os seguintes detalhes: * Condição para que o app seja dito como em conformidade : Todos os processos mencionados no processo primário devem estar em execução. * Condição para que o valor da métrica seja dito como em conformidade : O valor deve corresponder ao valor esperado configurado. {#dex-check-definitions-mac__ul_gl2_pqg_12c} * A pontuação é calculada usando esta fórmula: Pontuação (aplicação de reclamação e valor de métrica em conformidade) / (Valor total de aplicações e métrica - Reprovados) \*100 {#dex-check-definitions-mac__ul_fl2_pqg_12c} |
| os.mac.check-system-vpn-details | Obtenha os detalhes da VPN para o seu dispositivo. |
| os.mac.check-system-energy-consumption | Obtém energia consumida pela máquina Mac nos próximos 5 minutos. Nota: Os detalhes importantes desta definição de verificação estão listados abaixo: * /Usr/bin/powermetrics precisa ser adicionado às permissões do sudo. * A verificação levará aproximadamente cinco minutos para ser concluída, pois está calculando a energia consumida nos próximos cinco minutos * Esta definição de verificação não funcionará se o agente estiver instalado com o rosetta habilitado em máquinas M1, M2, M3. {#dex-check-definitions-mac__ul_dgm_lrg_12c} |
| os.mac.check-system-power-consumption | Obtém o consumo de energia para o dispositivo mac. |
[ ]

{#dex-check-definitions-mac__table_wtg_ydq_rwb}

## Verificar definições --- Ações de diagnóstico {#dex-check-definitions-mac__section_syx_nnj_swb}

DEX fornece os seguintes tipos de definições de verificação para Ações de diagnóstico.{#dex-check-definitions-mac__table_tyx_nnj_swb__entry__3}

| Verificar nome da definição | Verificar os parâmetros de definição | Descrição |
|-|-|-|
| os.mac.check-app-process-ids | --process_name=\<nome do processo\> | Recupera os IDs de processo (PIDs) dos processos primários e secundários associados à aplicação. |
| os.mac.check-process-cpu | N/D | Recupera uma lista de todos os processos em execução junto com a porcentagem de uso da CPU, tempo de CPU, ID de processo (PID), ID de processo primário (PPID) e nome. |
| os.mac.check-process-memory | N/D | Recupera uma lista de todos os processos em execução junto com o uso da memória em kilobytes (KB), ID de processo (PID), ID de processo primário (PPID) e nome. |
| os.mac.check-process-data | N/D | Recupera o uso da CPU, da memória e do disco de todos os processos em execução no momento. |
| os.mac.check-process-disk | N/D | Recupera uma lista de todos os processos em execução junto com o uso do disco em Bytes, ID de processo (PID), ID de processo primário (PPID) e nome. |
| os.mac.check-traceroute | --url=\<url\> --max_hops = \<o valor padrão é 65\> --timeout = \<o valor padrão é 5\> | Recupera o endereço IP, o nome do domínio e o tempo de ida e volta (RTT) para cada salto de rede. |
| os.mac.check-ping-test | --url=\<url\> | Envia uma solicitação de ping para o URL fornecido e retorna o status de conectividade, indicando se o URL está acessível ou não. |
| os.mac.check-services-data | Tipo de serviço (um de usuário, sistema ou todos) | Recupera a lista de todos os serviços com PID, Nome do serviço, Status, Tipo de serviço. |
[ ]

{#dex-check-definitions-mac__table_tyx_nnj_swb}

## Verificar definições --- Ações de remediação {#dex-check-definitions-mac__section_vz4_qb3_bzb}

DEX fornece os seguintes tipos de definições de verificação para Ações de remediação.{#dex-check-definitions-mac__table_ink_wb3_bzb__entry__3}

| Verificar nome da definição | Verificar os parâmetros de definição | Descrição |
|-|-|-|
| os.mac.action-kill-process | --pid=\<id de processo\> OU --process_name=\<nome do arquivo executável\> Nota: O ID do processo tem prioridade sobre o nome da aplicação. | Encerra um processo em execução ou vários processos especificados por seu ID de processo (PID) ou nome de arquivo executável (.app). |
| os.mac.action-restart-service | --service_name=\<nome do serviço\> | Reinicia os serviços de usuário conectado que usam um nome de serviço como entrada para o sistema. |
[ ]

{#dex-check-definitions-mac__table_ink_wb3_bzb}