ltm lsn-log-profile

ltm lsn-log-profile(1)				  BIG-IP TMSH Manual			       ltm lsn-log-profile(1)

NAME
       lsn-log-profile - Configures a Large-Scale Network Address Translation logging profile.

MODULE
       ltm

SYNTAX
   CREATE/MODIFY
	create lsn-log-profile [name]
	modify lsn-log-profile [name | all]
	  options:
	    app-service [[string] | none]
	    csv-format [disabled | enabled]
	    start-outbound-session {
		action [disabled | enabled | backup-allocation-only]
		elements [add | delete | replace-all-with] {
		    destination
		}
	    }
	    end-outbound-session {
		action [disabled | enabled | backup-allocation-only]
		elements [add | delete | replace-all-with] {
		    destination
		}
	    }
	    start-inbound-session {
		action [disabled | enabled | backup-allocation-only]
	    }
	    end-inbound-session {
		action [disabled | enabled | backup-allocation-only]
	    }
	    quota-exceeded {
		action [disabled | enabled ]
	    }
	    errors {
		action [disabled | enabled ]
	    }
	    subscriber-id [disabled | enabled]

	edit lsn-log-profile [ [ [name] | [glob] | [regex] ] ... ]
	  options:
	    all-properties
	    non-default-properties

	reset-stats lsn-log-profile
	reset-stats lsn-log-profile [ [ [name] | [glob] | [regex] ] ... ]

   DISPLAY
	list lsn-log-profile
	list lsn-log-profile [ [ [name] | [glob] | [regex] ] ... ]
	show running-config lsn-log-profile
	show running-config lsn-log-profile [ [ [name] | [glob] | [regex] ] ... ]
	  options:
	    all-properties
	    non-default-properties
	    one-line

   DELETE
	delete lsn-log-profile [name | all]

DESCRIPTION
       A LSN log profile allows fine grain control of the logging for LSN translation events.  When attached to an
       LSN pool, you can control the events to enable logging, and the elements in the log entry.

EXAMPLES
       create ltm lsn-log-profile my_lsn_log_profile end-inbound-session { action enabled } end-outbound-session {
       action enabled }

       Creates the LSN log profile my_lsn_log_profile that generates log entries for both inbound and session when
       the translation session ends.

       delete lsn-log-profile my_lsn_log_profile

       Deletes the LSN log profile named my_lsn_log_profile.

OPTIONS
       app-service
	    Specifies the name of the application service to which this object belongs. The default value is none.

	    Note: If the strict-updates option is enabled on the application service that owns the object, you cannot
	    modify or delete this object. Only the application service can modify or delete this object.

       csv-format
	    When enabled, use CSV log format for log entries. The default value is disabled.

       events
	    The type of LSN translation events available for logging control.

	    start-outbound-session
		 Event for start of outbound translation session, when the outbound flow is created.

	    end-outbound-session
		 Event for end of outbound translation session, when the outbound flow is deleted.

	    start-inbound-session
		 Event for start of incoming connection to a translated address.

	    end-inbound-session
		 Event for end of incoming connection to a translated address.

	    quota-exceeded
		 Event for when client exceeded allocated resource limit.

	    errors
		 Event for when LSN encountered errors while attempting translation for clients.

	    subscriber-id
		 When enabled, the subscriber ID associated with a subscriber IP address will be printed in the logs.

       action
	    Specify the logging action to be taken when a particular event is encountered.

	    enabled
		 Logging is enable for the event, whether translation is from the primary pool member or backup pool
		 member.

	    backup-allocation-only
		 Logging is enable for the event, when translation is take from backup pool member only.

	    disabled
		 Logging is disable for the event.

       elements
	    Optional elements that can be added to the log message.

       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.

SEE ALSO
       ltm lsn-pool, create, delete, edit, glob, list, ltm, modify, regex, show, 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-2014. All rights reserved.

BIG-IP						      2017-02-15			       ltm lsn-log-profile(1)