Product documentation Docs
    • English
    • Deutsch
    • 日本語
    • 한국어
    • Français
  • More Sites
    • Now Community
    • Developer Site
    • Knowledge Base
    • Product Information
    • ServiceNow.com
    • Training
    • Customer Success Center
    • ServiceNow Support Videos
  • Log in

Product documentation

  • Home
How search works:
  • Punctuation and capital letters are ignored
  • Special characters like underscores (_) are removed
  • Known synonyms are applied
  • The most relevant topics (based on weighting and matching to search terms) are listed first in search results
Topics are ranked in search results by how closely they match your search terms
  • A match on the entire phrase you typed
  • A match on part of the phrase you typed
  • A match on ALL of the terms in the phrase you typed
  • A match on ANY of the terms in the phrase you typed

Note: Matches in titles are always highly ranked.

  • Release version
    Table of Contents
    • Analytics, Intelligence, and Reporting
Table of Contents
Choose your release version
    Home Paris Analytics, Intelligence, and Reporting Analytics, Intelligence, and Reporting Performance Analytics Performance Analytics advanced topics Performance Analytics data collection Create or schedule a data collection job

    Create or schedule a data collection job

    • Save as PDF Selected topic Topic & subtopics All topics in contents
    • Unsubscribe Log in to subscribe to topics and get notified when content changes.
    • Share this page

    Create or schedule a data collection job

    Schedule a data collection job to regularly collect scores.

    Before you begin

    Before defining data collection jobs, make sure that indicator sources, breakdown sources, and indicators have been defined. Otherwise, jobs cannot return any results.

    Roles required: pa_data_collector or admin

    About this task

    The important items to know when you configure a data collection job are:
    • Collection period
    • Collection timezone
    • Collected scores domain, if domains are used.
    • The collection job runs without any restrictions. It does not use the permissions of the user who runs it.

    Data collection jobs run different steps to collect scores and to collect text analytics data. By default, jobs collect both types of data. To improve performance, you can instead schedule separate jobs for scores and for text analytics data.

    Procedure

    1. Navigate to Performance Analytics > Data Collector > Jobs and click New.
      You can instead edit an existing data collection job, for example to change the schedule of when the job runs. In this case, navigate to Performance Analytics > Data Collector > Jobs and click the job name.
    2. In the Name field, give the job a meaningful name.
      Follow a standard format for naming data collector jobs, such as [PA Indicator] Daily Data Collection, [PA Indicator] Historic Data Collection...
    3. In the Operator field, select whether to collect data for an absolute or a relative time period.
      Operator valueDescription
      Fixed Collects data for an absolute time period.
      Relative Collect data for a period of time that is relative to the time when the job is run.
    4. If you selected Fixed as the operator, select the Fixed start date and the Fixed end date.
    5. If you selected Relative as the operator, specify the intervals prior to the run time to collect data from.
      If you set relative start 1 and relative end 1 and intervals of "days ago," you collect data only for yesterday.
      1. In the fields Relative start and Relative start interval, set the number and the length, respectively, of time periods in the past to begin to collect data from.
      2. In the fields Relative end and Relative end interval, set the number and the length, respectively, of the last period in the past to collect data from.
        Tip: Most indicators, and therefore most data collection jobs, run Daily. Daily scheduled jobs normally should collect for the most recently completed day. Therefore, they should have both a relative start and relative end of one day ago. Run historical data collection jobs, which have longer collection periods, only once.
        For example, you want to collect scores for a set of several new indicators with a daily frequency, all using the same indicator source. First you create a historical data collection job that collects data from two months ago up to the day before yesterday. For this job, enter 60 in Relative start and days ago in Relative start interval. Enter 2 in Relative end and days ago in Relative end interval. Set the Run field to On Demand. Click Execute now and run this job once, to collect the initial scores.

        Create a second job with relative start and end of 1 day ago and set the Run field to Daily. Activate this job to collect the scores for yesterday and all future scores for the day before the job is run.

    6. Fill in the Job parameters, as appropriate.
      Job parameter Description
      Run as Select the user that runs this scheduled job. The data collection job does not use the permissions of this user. ACLs and business rules do not apply to data collection jobs. Any user can run the job. However, if you have enabled domain support but do not configure domains for this job, the records retrieved from the indicator source respect the domain of this user.
      Run as tz Select the time zone that the queries use when they are executed from the job. Use the reporting time zone of your company if one exists. By default the System time zone is used.

      This time zone determines what day is "Today" for conditions like [[Opened][on][Today]].

      Active If selected, as it is by default, the data collection occurs at the scheduled date and time.
      Run Select the schedule for collecting the data. Choices are:
      • Daily
      • Weekly
      • Monthly
      • Periodically
      • Once
      • On demand

      If you are creating a historical data collection job, schedule the job to run On demand.

      Day
      • If Run is Weekly, specify the day of the week.
      • If Run is Monthly, specify the day of the month.

      To collect at the end of the month, set for day 1 and set Time to soon after midnight. This setting collects data for a completed month regardless of the length of the month.

      Repeat Interval If Run is Periodically, specify the amount of time between scheduled data collections, in days and hour.
      Starting If Run is Periodically or Once, specify the date and time of the first scheduled data collection.
      Time Time that the job runs, on 24 hour clock. Field appears after Active is selected.
      • Time based on the time zone for your user session, not the Run as tz time zone.
      • Generally set for an hour between midnight and 6 am at your company, to collect the last complete period.

      For example, if you are in New York and want to collect data at 5 am for your company that is on Los Angeles time, set the time to 08:00:00.

      Collect Data collection jobs have separate steps for collecting scores and for collecting text analytics. Select one of:
      • Scores only
      • Text index only
      • Both scores and text index (default)

      For more information, see Set up text analytics.

      Conditional If checked, the data collection occurs only if certain conditions are met.
      Conditions If Conditional is selected, write a script that specifies under what conditions the job is run.
    7. Right-click the form header and select Save.
    8. In the Indicators related list, click Edit and select the indicators that this job collects data for.
      Important:
      • Include at least one indicator for the job. Otherwise, the job cannot return any results.
      • To help keep jobs maintainable, try not to associate an indicator with more than one active collection job unless you have a clear use case. If you are trying to get real-time data, consider using a real-time indicator.
      Note: The data collection job produces one database query for each indicator source for the associated indicators. Thus the data for all indicators that share an indicator source represent the same point in time.
    9. Click Submit.

    What to do next

    • By default, for each job indicator, data is collected for all breakdowns and the indicator itself. To change this configuration for an indicator, see Configure a job indicator.
    • If you have enabled domain support, you have a related list named Domain configuration. In this tab, click Edit to relate an existing domain configuration with this job or click New to create a new domain configuration. For more information, see Create a domain configuration.

    Tags:

    Feedback
    On this page

    Previous topic

    Next topic

    • Contact Us
    • Careers
    • Terms of Use
    • Privacy Statement
    • Sitemap
    • © ServiceNow. All rights reserved.

    Release version
    Choose your release version

      Create or schedule a data collection job

      • Save as PDF Selected topic Topic & subtopics All topics in contents
      • Unsubscribe Log in to subscribe to topics and get notified when content changes.
      • Share this page

      Create or schedule a data collection job

      Schedule a data collection job to regularly collect scores.

      Before you begin

      Before defining data collection jobs, make sure that indicator sources, breakdown sources, and indicators have been defined. Otherwise, jobs cannot return any results.

      Roles required: pa_data_collector or admin

      About this task

      The important items to know when you configure a data collection job are:
      • Collection period
      • Collection timezone
      • Collected scores domain, if domains are used.
      • The collection job runs without any restrictions. It does not use the permissions of the user who runs it.

      Data collection jobs run different steps to collect scores and to collect text analytics data. By default, jobs collect both types of data. To improve performance, you can instead schedule separate jobs for scores and for text analytics data.

      Procedure

      1. Navigate to Performance Analytics > Data Collector > Jobs and click New.
        You can instead edit an existing data collection job, for example to change the schedule of when the job runs. In this case, navigate to Performance Analytics > Data Collector > Jobs and click the job name.
      2. In the Name field, give the job a meaningful name.
        Follow a standard format for naming data collector jobs, such as [PA Indicator] Daily Data Collection, [PA Indicator] Historic Data Collection...
      3. In the Operator field, select whether to collect data for an absolute or a relative time period.
        Operator valueDescription
        Fixed Collects data for an absolute time period.
        Relative Collect data for a period of time that is relative to the time when the job is run.
      4. If you selected Fixed as the operator, select the Fixed start date and the Fixed end date.
      5. If you selected Relative as the operator, specify the intervals prior to the run time to collect data from.
        If you set relative start 1 and relative end 1 and intervals of "days ago," you collect data only for yesterday.
        1. In the fields Relative start and Relative start interval, set the number and the length, respectively, of time periods in the past to begin to collect data from.
        2. In the fields Relative end and Relative end interval, set the number and the length, respectively, of the last period in the past to collect data from.
          Tip: Most indicators, and therefore most data collection jobs, run Daily. Daily scheduled jobs normally should collect for the most recently completed day. Therefore, they should have both a relative start and relative end of one day ago. Run historical data collection jobs, which have longer collection periods, only once.
          For example, you want to collect scores for a set of several new indicators with a daily frequency, all using the same indicator source. First you create a historical data collection job that collects data from two months ago up to the day before yesterday. For this job, enter 60 in Relative start and days ago in Relative start interval. Enter 2 in Relative end and days ago in Relative end interval. Set the Run field to On Demand. Click Execute now and run this job once, to collect the initial scores.

          Create a second job with relative start and end of 1 day ago and set the Run field to Daily. Activate this job to collect the scores for yesterday and all future scores for the day before the job is run.

      6. Fill in the Job parameters, as appropriate.
        Job parameter Description
        Run as Select the user that runs this scheduled job. The data collection job does not use the permissions of this user. ACLs and business rules do not apply to data collection jobs. Any user can run the job. However, if you have enabled domain support but do not configure domains for this job, the records retrieved from the indicator source respect the domain of this user.
        Run as tz Select the time zone that the queries use when they are executed from the job. Use the reporting time zone of your company if one exists. By default the System time zone is used.

        This time zone determines what day is "Today" for conditions like [[Opened][on][Today]].

        Active If selected, as it is by default, the data collection occurs at the scheduled date and time.
        Run Select the schedule for collecting the data. Choices are:
        • Daily
        • Weekly
        • Monthly
        • Periodically
        • Once
        • On demand

        If you are creating a historical data collection job, schedule the job to run On demand.

        Day
        • If Run is Weekly, specify the day of the week.
        • If Run is Monthly, specify the day of the month.

        To collect at the end of the month, set for day 1 and set Time to soon after midnight. This setting collects data for a completed month regardless of the length of the month.

        Repeat Interval If Run is Periodically, specify the amount of time between scheduled data collections, in days and hour.
        Starting If Run is Periodically or Once, specify the date and time of the first scheduled data collection.
        Time Time that the job runs, on 24 hour clock. Field appears after Active is selected.
        • Time based on the time zone for your user session, not the Run as tz time zone.
        • Generally set for an hour between midnight and 6 am at your company, to collect the last complete period.

        For example, if you are in New York and want to collect data at 5 am for your company that is on Los Angeles time, set the time to 08:00:00.

        Collect Data collection jobs have separate steps for collecting scores and for collecting text analytics. Select one of:
        • Scores only
        • Text index only
        • Both scores and text index (default)

        For more information, see Set up text analytics.

        Conditional If checked, the data collection occurs only if certain conditions are met.
        Conditions If Conditional is selected, write a script that specifies under what conditions the job is run.
      7. Right-click the form header and select Save.
      8. In the Indicators related list, click Edit and select the indicators that this job collects data for.
        Important:
        • Include at least one indicator for the job. Otherwise, the job cannot return any results.
        • To help keep jobs maintainable, try not to associate an indicator with more than one active collection job unless you have a clear use case. If you are trying to get real-time data, consider using a real-time indicator.
        Note: The data collection job produces one database query for each indicator source for the associated indicators. Thus the data for all indicators that share an indicator source represent the same point in time.
      9. Click Submit.

      What to do next

      • By default, for each job indicator, data is collected for all breakdowns and the indicator itself. To change this configuration for an indicator, see Configure a job indicator.
      • If you have enabled domain support, you have a related list named Domain configuration. In this tab, click Edit to relate an existing domain configuration with this job or click New to create a new domain configuration. For more information, see Create a domain configuration.

      Tags:

      Feedback

          Share this page

          Got it! Feel free to add a comment
          To share your product suggestions, visit the Idea Portal.
          Please let us know how to improve this content

          Check any that apply

          To share your product suggestions, visit the Idea Portal.
          Confirm

          We were unable to find "Coaching" in Jakarta. Would you like to search instead?

          No Yes
          • Contact Us
          • Careers
          • Terms of Use
          • Privacy Statement
          • Sitemap
          • © ServiceNow. All rights reserved.

          Subscribe Subscribed Unsubscribe Last updated: Tags: January February March April May June July August September October November December No Results Found Versions Search preferences successfully updated My release version successfully updated My release version successfully deleted An error has occurred. Please try again later. You have been unsubscribed from all topics. You are now subscribed to and will receive notifications if any changes are made to this page. You have been unsubscribed from this content Thank you for your feedback. Form temporarily unavailable. Please try again or contact  docfeedback@servicenow.com  to submit your comments. The topic you requested does not exist in the release. You were redirected to a related topic instead. The available release versions for this topic are listed There is no specific version for this documentation. Explore products Click to go to the page. Release notes and upgrades Click to open the dropdown menu. Delete Remove No selected version Reset This field is required You are already subscribed to this topic Attach screenshot The file you uploaded exceeds the allowed file size of 20MB. Please try again with a smaller file. Please complete the reCAPTCHA step to attach a screenshot
          Log in to personalize your search results and subscribe to topics
          No, thanks Login