kmp_rtmp_out_notif_url
The kmp_rtmp_out_notif_url directive specifies a notification URL that Kaltura Media Framework components will call after streaming events.
Описание
The kmp_rtmp_out_notif_url directive is designed to integrate Kaltura Media Framework with RTMP streaming services by allowing the specification of a notification URL. When a streaming event occurs, NGINX will send an HTTP POST request to the provided URL containing relevant event details. This is particularly useful for orchestrating streaming media workflows where an external service needs to be informed of media state changes such as when a stream starts, stops, or encounters issues. The notification can trigger further actions, like scaling resources or notifying user interfaces.
The directive can be used at both the stream and stream server contexts within an NGINX configuration, allowing you to specify a unified notification URL for all streams handled by that server block. By providing a single URL, all RTMP outputs from the specified context will leverage the same endpoint for notifications, leading to simpler configurations when managing multiple streams. Ensure that the notification service is properly prepared to handle the responses from NGINX to avoid any disruption in the workflow.
When configuring this directive, you should provide a single argument: the URL to which the notification should be sent. It is crucial for the specified URL to be reachable and capable of handling the incoming requests to effectively use this directive. If the URL is not reachable or returns errors, the notification feature may fail, impacting the overall streaming orchestration.
Пример конфига
stream {
server {
listen 1935;
kmp_rtmp_out_notif_url http://example.com/notify;
application live {
live on;
}
}
}Ensure the notification URL is reachable from the server running NGINX.
Verify that the receiving service can handle the HTTP POST requests without error.
Be cautious of network timeouts which might prevent notifications from being sent.