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)