{"id":9524,"date":"2022-06-21T09:11:27","date_gmt":"2022-06-21T09:11:27","guid":{"rendered":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/documentation\/device_management\/telemetry_2\/telemetry_2-0_report_profiles\/parameter_types\/parameter_types_grep\/"},"modified":"2025-03-25T05:18:32","modified_gmt":"2025-03-25T05:18:32","slug":"parameter_types_grep","status":"publish","type":"page","link":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/parameter_types_grep\/","title":{"rendered":"Parameter Types: grep"},"content":{"rendered":"\n
\n
\n
\n
\n
<\/div><\/div>\n<\/div>\n<\/div>\n
\n
\n
\n

“grep” Parameter Properties<\/u><\/h2>

A grep parameter defines report data that comes from searching a log file for a particular string.<\/p>

Example<\/h3>
\n
{\n   \"type\": \"grep\",\n   \"marker\": \"T2_btime_dsLock_split\",\n   \"search\": \"Downstream Lock Success=\", \n   \"logFile\": \"BootTime.log\",\n   \"use\": \"absolute\"\n}<\/pre>\n<\/div><\/div>
Available Properties<\/span><\/h3>
 <\/colgroup>
Property<\/p><\/th>
Type<\/p><\/th>
Required<\/p><\/th><\/tr><\/thead>
type<\/a><\/td>string<\/code><\/td>Required<\/td><\/tr>
marker<\/a><\/td>string<\/code><\/td>Required<\/td><\/tr>
search<\/a><\/td>string<\/code><\/td>Required<\/td><\/tr>
logFile<\/a><\/td>string<\/code><\/td>Required<\/td><\/tr>
use<\/a><\/td>string<\/code><\/td>Optional<\/td><\/tr>
reportEmpty<\/a><\/td>boolean<\/code><\/td>Optional<\/td><\/tr><\/tbody><\/table><\/div><\/div>\n<\/div>\n<\/div>\n
\n
\n
\n
type<\/h3>
Defines a grep parameter<\/p>
type<\/code><\/p>
  • is required<\/li>
  • Type: <\/span>string<\/code><\/li><\/ul>
    type Constraints<\/h3>
    constant<\/strong>: the value of this property must be equal to:<\/p>
    \"grep\"<\/code>

    <\/pre><\/div>\n<\/div>\n<\/div>\n
    \n
    \n
    \n
    marker<\/h3>
    The key name to be used for this data in the generated report.<\/p>
    marker<\/code><\/p>
    • is required<\/li>
    • Type: <\/span>string<\/code><\/li><\/ul>

      <\/p><\/div>\n<\/div>\n<\/div>\n
      \n
      \n
      \n
      search<\/h3>
      The string for which to search within the log file.<\/p>
      search<\/code><\/p>
      • is required<\/li>
      • Type: <\/span>string<\/code><\/li><\/ul>

        <\/p><\/div>\n<\/div>\n<\/div>\n
        \n
        \n
        \n
        logFile<\/h3>
        The name of the log file to be searched.<\/p>
        logFile<\/code><\/p>
        • is required<\/li>
        • Type: <\/span>string<\/code><\/li><\/ul>

          <\/p><\/div>\n<\/div>\n<\/div>\n
          \n
          \n
          \n
          use<\/h3>
          This property indicates how the data for this parameter should be gathered and reported.<\/p>
          use<\/code><\/p>
          • is optional<\/li>
          • Type: <\/span>string<\/code><\/li>
          • example:<\/li><\/ul>
              \"use\":\"count\"\n<\/code><\/pre>
            use Constraints<\/h3>
            enum<\/strong>: the value of this property must be equal to one of the following values:<\/p>
             <\/colgroup>
            Value<\/p><\/th>
            Explanation<\/p><\/th><\/tr><\/thead>
            \"count\"<\/code><\/td>Indicates that the value to report for this parameter is the number of times it has occurred during the reporting interval.<\/td><\/tr>
            \"absolute\"<\/code><\/td>Indicates that the value to report for this parameter is the last actual value received, in the case of events, or found in the log file, in the case of greps.<\/td><\/tr>
            \"csv\"<\/code><\/td>Indicates that the value to report for this parameter is a comma separated list of all the actual values received, in the case of events, or found in the log file, in the case of greps. <\/span>NOTE:<\/strong> <\/span>“csv” is not currently supported in Telemetry 2.0.<\/td><\/tr><\/tbody><\/table><\/div>
            use Default Value<\/h3>
            The default value is:<\/p>
            \"absolute\"\n<\/code><\/pre>

            <\/p><\/div>\n<\/div>\n<\/div>\n
            \n
            \n
            \n
            reportEmpty<\/span><\/h3>
            Should this marker name be included in the generated report even if the search string was not found in the log file?<\/p>
            reportEmpty<\/code><\/p>
            • is optional<\/li>
            • Type: <\/span>boolean<\/code><\/li><\/ul>
              reportEmpty Default Value<\/h3>
              The default value is:<\/p>
              \"false\"\n<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n<\/div><\/body><\/html>\n","protected":false},"excerpt":{"rendered":"
              “grep” Parameter Properties A grep parameter defines report data that comes from searching a log […]<\/p>\n","protected":false},"author":28,"featured_media":0,"parent":9518,"menu_order":2,"comment_status":"open","ping_status":"closed","template":"","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"footnotes":""},"class_list":["post-9524","page","type-page","status-publish","hentry"],"yoast_head":"\nParameter Types: grep - RDK Documentation Portal | Documentation<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/parameter_types_grep\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Parameter Types: grep - RDK Documentation Portal | Documentation\" \/>\n<meta property=\"og:description\" content=\"“grep” Parameter Properties A grep parameter defines report data that comes from searching a log […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/parameter_types_grep\/\" \/>\n<meta property=\"og:site_name\" content=\"RDK Documentation Portal | Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-03-25T05:18:32+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/parameter_types_grep\/\",\"url\":\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/parameter_types_grep\/\",\"name\":\"Parameter Types: grep - RDK Documentation Portal | Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/developer.rdkcentral.com\/documentation\/#website\"},\"datePublished\":\"2022-06-21T09:11:27+00:00\",\"dateModified\":\"2025-03-25T05:18:32+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/parameter_types_grep\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/parameter_types_grep\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/parameter_types_grep\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/developer.rdkcentral.com\/documentation\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Documentation\",\"item\":\"https:\/\/developer.rdkcentral.com\/documentation\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Device Management\",\"item\":\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Xconf\",\"item\":\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Telemetry 2.0\",\"item\":\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/\"},{\"@type\":\"ListItem\",\"position\":6,\"name\":\"Telemetry 2.0: Report Profiles\",\"item\":\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/\"},{\"@type\":\"ListItem\",\"position\":7,\"name\":\"Parameter Types\",\"item\":\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/\"},{\"@type\":\"ListItem\",\"position\":8,\"name\":\"Parameter Types: grep\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/developer.rdkcentral.com\/documentation\/#website\",\"url\":\"https:\/\/developer.rdkcentral.com\/documentation\/\",\"name\":\"RDK Documentation Portal | Documentation\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/developer.rdkcentral.com\/documentation\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Parameter Types: grep - RDK Documentation Portal | Documentation","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/parameter_types_grep\/","og_locale":"en_US","og_type":"article","og_title":"Parameter Types: grep - RDK Documentation Portal | Documentation","og_description":"“grep” Parameter Properties A grep parameter defines report data that comes from searching a log […]","og_url":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/parameter_types_grep\/","og_site_name":"RDK Documentation Portal | Documentation","article_modified_time":"2025-03-25T05:18:32+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/parameter_types_grep\/","url":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/parameter_types_grep\/","name":"Parameter Types: grep - RDK Documentation Portal | Documentation","isPartOf":{"@id":"https:\/\/developer.rdkcentral.com\/documentation\/#website"},"datePublished":"2022-06-21T09:11:27+00:00","dateModified":"2025-03-25T05:18:32+00:00","breadcrumb":{"@id":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/parameter_types_grep\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/parameter_types_grep\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/parameter_types_grep\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/developer.rdkcentral.com\/documentation\/"},{"@type":"ListItem","position":2,"name":"Documentation","item":"https:\/\/developer.rdkcentral.com\/documentation\/"},{"@type":"ListItem","position":3,"name":"Device Management","item":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/"},{"@type":"ListItem","position":4,"name":"Xconf","item":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/"},{"@type":"ListItem","position":5,"name":"Telemetry 2.0","item":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/"},{"@type":"ListItem","position":6,"name":"Telemetry 2.0: Report Profiles","item":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/"},{"@type":"ListItem","position":7,"name":"Parameter Types","item":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/telemetry_2-0_report_profiles\/parameter_types\/"},{"@type":"ListItem","position":8,"name":"Parameter Types: grep"}]},{"@type":"WebSite","@id":"https:\/\/developer.rdkcentral.com\/documentation\/#website","url":"https:\/\/developer.rdkcentral.com\/documentation\/","name":"RDK Documentation Portal | Documentation","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/developer.rdkcentral.com\/documentation\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/pages\/9524","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/users\/28"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/comments?post=9524"}],"version-history":[{"count":2,"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/pages\/9524\/revisions"}],"predecessor-version":[{"id":9546,"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/pages\/9524\/revisions\/9546"}],"up":[{"embeddable":true,"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/pages\/9518"}],"wp:attachment":[{"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/media?parent=9524"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}