---
title: "os_signpost(_:dso:log:name:signpostID:_:_:)"
framework: os
role: symbol
role_heading: Function
path: "os/os_signpost(_:dso:log:name:signpostid:_:_:)-nez5"
---

# os_signpost(_:dso:log:name:signpostID:_:_:)

Logs the beginning of an animation as a point-of-interest in your code, and includes the specified message in the logs.

## Declaration

```swift
func os_signpost(_ animationBegin: OSSignpostAnimationBegin, dso: UnsafeRawPointer = #dsohandle, log: OSLog, name: StaticString, signpostID: OSSignpostID = .exclusive, _ format: AnimationFormatString.OSLogMessage, _ arguments: any CVarArg...)
```

## Parameters

- `animationBegin`: The type of animation signpost to create.
- `log`: The log object to write the signpost to.
- `name`: The name of the signpost.
- `signpostID`: A signpost identifier you use to disambiguate between signposts with the same name. If you specify doc://com.apple.os/documentation/os/OSSignpostID/invalid or doc://com.apple.os/documentation/os/OSSignpostID/null for this parameter, this method does nothing.
- `format`: A constant string or format string that produces a human-readable log message.
- `arguments`: Additional arguments to substitute into the format string parameter. Pass the expected number of arguments in the order that they appear in the string. If format is a constant string, don’t include any additional arguments.

## See Also

### Measure Events

- [os_signpost(_:dso:log:name:signpostID:)](os/os_signpost(_:dso:log:name:signpostid:)-2oz8u.md)
- [os_signpost(_:dso:log:name:signpostID:_:_:)](os/os_signpost(_:dso:log:name:signpostid:_:_:)-2om9b.md)
- [OSSignpostType](os/ossignposttype.md)
- [os_signpost(_:dso:log:name:signpostID:)](os/os_signpost(_:dso:log:name:signpostid:)-12m3v.md)
- [OSSignpostAnimationBegin](os/ossignpostanimationbegin.md)
- [AnimationFormatString](os/animationformatstring.md)
- [os_signpost_id_t](os/os_signpost_id_t.md)