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)