ltm profile dns-logging

ltm profile dns-logging(1)    BIG-IP TMSH Manual    ltm profile dns-logging(1)



NAME
       dns-logging - Configures a domain name service logging (DNS Logging)
       profile.

MODULE
       ltm profile

SYNTAX
       Configure the dns-logging component within the ltm profile module using
       the syntax in the following sections.

   CREATE/MODIFY
	create dns-logging [name]
	modify dns-logging [name]
	  options:
	    description [string]
	    enable-query-logging [no | yes]
	    enable-response-logging [no | yes]
	    include-complete-answer [no | yes]
	    include-query-id [no | yes]
	    include-source [no | yes]
	    include-timestamp [no | yes]
	    include-view [no | yes]
	    log-publisher [name]

	edit dns-logging [ [ [name] | [glob] | [regex] ] ... ]
	  options:
	    all-properties
	    non-default-properties

	mv dns-logging [ [[source-name] [destination-name]] | [[name] to-folder [folder-name]] | [[name...name] to-folder [folder-name]] ]
	  options:
	    to-folder

   DISPLAY
	list dns-logging
	list dns-logging [ [ [name] | [glob] | [regex] ] ... ]
	  options:
	    all-properties
	    non-default-properties
	    one-line
	    partition

   DELETE
	delete dns-logging [name]

DESCRIPTION
       You can use this component to create, modify, display, or delete a DNS
       logging profile, to enable query or response logging, and to define the
       format of messages themselves.

EXAMPLES
       list dns-logging

       Displays the properties of all DNS logging profiles.

       create dns-logging my_dns_log_profile enable-query-logging yes log-
       publisher my_pub include-query-id yes

       Creates a DNS logging profile with query logging enabled. Messages will
       be sent to publisher my_pub. Messages will contain the query ID.

       mv dns-logging /Common/my_dns_logging_profile to-folder
       /Common/my_folder

       Moves a custom dns-logging profile named my_dns_logging_profile to a
       folder named my_folder, where my_folder has already been created and
       exists within /Common.

OPTIONS
       description
	    User defined description.

       enable-query-logging
	    Log the contents of DNS queries. The default value for this option
	    is yes.

       enable-response-logging
	    Log the contents of DNS responses. The default value is no.

       glob Displays the items that match the glob expression. See help glob
	    for a description of glob expression syntax.

       include-complete-answer
	    Selects whether all the resource records are included in response
	    log messages. The default value is yes (complete-answer).

       include-query-id
	    Selects whether the query id sent by the client is included in the
	    query and response log messages. The default value is no.

       include-source
	    Selects whether the message originator is included in the query
	    and response log messages. The default value is yes.

       include-timestamp
	    Selects whether the time stamp of the message is included in the
	    query and response log messages. The default value is yes. You may
	    or may not need this depending on whether the destination log
	    servers prepend a time stamp to messages.

       include-view
	    Selects whether the view is included in the query log messages.
	    The default value is yes.

       log-publisher
	    Specifies the log publisher used to deliver messages to one or
	    more destinations. This option must be specified.

       regex
	    Displays the items that match the regular expression. The regular
	    expression must be preceded by an at sign (@[regular expression])
	    to indicate that the identifier is a regular expression. See help
	    regex for a description of regular expression syntax.

       to-folder
	    dns-logging profiles can be moved to any folder under /Common, but
	    configuration dependencies may restrict moving the profile out of
	    /Common.

SEE ALSO
       create, delete, edit, glob, list, modify, mv, regex, ltm profile dns,
       tmsh

COPYRIGHT
       No part of this program may be reproduced or transmitted in any form or
       by any means, electronic or mechanical, including photocopying,
       recording, or information storage and retrieval systems, for any
       purpose other than the purchaser's personal use, without the express
       written permission of F5 Networks, Inc.

       F5 Networks and BIG-IP (c) Copyright 2008-2013, 2015. All rights
       reserved.



BIG-IP				  2015-07-14	    ltm profile dns-logging(1)