{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":32382,"path":"it-service-management/digital-end-user-experience-dex/create-agent-policy.md","title":"Create an agent policy","bundle":null,"doc_type":null,"release":"australia","body":"\n# Create an agent policy\n\nCreate an agent policy by configuring a filter that determines the Configuration Items \\(CI\\) to run the checks and the metrics that are collected.\n\n## Before you begin\n\nConfirm that the DEX plugin \\(sn\\_dex\\) is installed.\n\nRole required: admin\n\n## Procedure\n\n1.  Navigate to **Workspaces** &gt; **Service Operations Workspace**.\n\n2.  In the primary navigation pane, select the DEX Administration icon \\(\\[Omitted image \"icon-administration.png\"\\] Alt text:\\).\n\n3.  In the Device and application configuration section, select **Manage policies** on the Agent policies card.\n\n4.  Select **New**.\n\n5.  Provide a descriptive name and description for the policy.\n\n    **Note:** In the **Publish status**, the value is set to *Draft*. After you create and save the policy, the **Publish status** value changes to *Ready to publish*. In the **Hierarchy** field, the value is set to *None*. If you create a child for the current policy, the value changes to *Parent*.\n\n6.  On the **Monitored CIs** tab, select one of the following options.\n\n<table id=\"choicetable_en5_d41_52c\"><thead><tr><th align=\"left\" id=\"d253895e156\">\n\nOption\n\n</th><th align=\"left\" id=\"d253895e159\">\n\nDescription\n\n</th></tr></thead><tbody><tr><td id=\"d253895e165\">\n\n**Manual calculation**\n\n</td><td>\n\nSelect to exclude the policy from scheduled policy calculation, ignoring any changes to the policy impacted CIs.Select this option when the policy monitors a single CI. The option enables you to avoid a long completion time for the Refresh and Publish Monitoring Policies scheduled job.\n\n</td></tr><tr><td id=\"d253895e176\">\n\n**Monitored CI type by filter**\n\n</td><td>\n\n1.  In the **Monitored CI type** field, select the CI type, which you want the policy checks to monitor.\n2.  In the **Filter** field, configure a filter so that the policy checks monitor only CI types, which meet the specified criteria. CI **tags** are included in the available criteria.\n\n\n</td></tr><tr><td id=\"d253895e203\">\n\n**Monitored CI type by script**\n\n</td><td>\n\nSpecify the monitored CIs using a script. Using a script enables you to create a CI filter for several tables related to each other. For example, you can set a filter in both a Linux servers table and an Oracle table when searching for a CI.\n\n</td></tr><tr><td id=\"d253895e214\">\n\n**Monitored CI type by CMDB Group**\n\n</td><td>\n\nSpecify the monitored CIs by using CMDB group queries. When selected, the **Monitored CMDB group** drop-down list of CMDB groups appears.\n\n</td></tr></tbody>\n</table>7.  On the **Checks** tab, select checks in the **Available** cell and use the arrow to move them to the **Selected** cell.\n\n    Checks can be selected multiple times when you’re monitoring more than one process. You can also select a group of checks in the **Filter checks by groups** field, which presents checks of the selected group in the **Available** cell.\n\n8.  On the **Proxy Settings** tab, configure a proxy server.\n\n    Configure a proxy server only when using the agent as a proxy to report data on remote machines.\n\n9.  On the **Scheduling** tab, select one of the following options.\n\n<table id=\"choicetable_elq_mdb_52c\"><thead><tr><th align=\"left\" id=\"d253895e279\">\n\nOption\n\n</th><th align=\"left\" id=\"d253895e282\">\n\nSteps\n\n</th></tr></thead><tbody><tr><td id=\"d253895e288\">\n\n**Interval-based scheduling**\n\n</td><td>\n\nConfigure the time interval \\(in seconds\\) to indicate the frequency with which the policy's checks run.\n\n</td></tr><tr><td id=\"d253895e297\">\n\n**Cron-based scheduling**\n\n</td><td>\n\nEnables configuring the policy to be active only during a specific time or time frames.1.  Select the Unlock icon \\(\\[Omitted image \"icon-acc-lock.png\"\\] Alt text: Unlock icon\\) to enable selecting cron expressions.\n2.  Select the search icon \\(\\[Omitted image \"search-icon.png\"\\] Alt text: Search icon\\), then select **New** to create a cron expression.\n\nYou can also select one of the following cron expressions that come with the base system:\n\n    -   Every hour nightly 5:00pm-7:00am\n    -   Every minute daily 8:00am-4:59pm\n    -   Every minute Mon-Fri 8:00am-4:59pm\nThe specified cron expression operates in the time zone of the machine hosting the agent.\n\n</td></tr></tbody>\n</table>    **Note:** If an **Interval** or **Cron** value was specified for the check definition, that value overrides the value configured in either of these fields.\n\n10. On the **Credentials** tab, select one of the following.\n\n    |Options|Steps|\n    |-------|-----|\n    |**Credential name**|Select credentials to be assigned to the policy. The available credentials are displayed on the associated check definition's **Check Secure Parameter Definitions** tab.|\n    |**Credential alias**|Select the Search icon \\[Omitted image \"search-icon.png\"\\] Alt text: Search icon to select a credential alias to be used by the policy's checks to connect to the monitored CI. The available options are created on the **Connection &amp; Credential Aliases** page.|\n\n11. Select **Save**.\n\n    The following buttons appear:\n\n    -   **Publish**: Publishes the Draft policy, moving its **Publish status** to **Queued**. A queued policy is processed by the policy publishing job. The job calculates which agents run the policy and then sends the policy to the relevant MID Servers. The job then moves the policy's **Publish status** to **Published**. A published policy is active on the agent.\n    -   **Delete**: Deletes the policy.\n\n"}}