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)