chore(log/docs): improve error log, docs (datahub-project#7239)

docs-website/sidebars.js

@@ -350,6 +350,11 @@ module.exports = {
             label: "Rest.li API",
             id: "docs/api/restli/restli-overview",
           },
+          {
+            type: "doc",
+            label: "Restore Indices",
+            id: "docs/api/restli/restore-indices",
+          },
           {
             type: "doc",
             label: "Aspect Versioning and Rest.li Modeling",

docs/api/restli/restore-indices.md

@@ -0,0 +1,19 @@
+# Restore Indices Endpoint
+
+You can do a HTTP POST request to `/gms/aspects?action=restoreIndices` endpoint with the `urn` as part of JSON Payload to restore indices for the particular URN.
+
+```
+curl --location --request POST 'https://demo.datahubproject.io/api/gms/aspects?action=restoreIndices' \
+--header 'Authorization: Bearer TOKEN' \
+--header 'Content-Type: application/json' \
+--data-raw '{
+    "urn": "YOUR_URN"
+}'
+```
+
+The supported parameters are
+- `urn` - Optionl URN string
+- `aspect` - Optional Aspect string
+- `urnLike` - Optional string regex to match URNs
+- `start` - Optional integer to decide which rows number of sql store to restore
+- `batchSize` - Optional integer to decide how many rows to restore

docs/how/restore-indices.md

@@ -52,13 +52,4 @@ Once the job completes, your indices will have been restored.
 
 ## Through API
 
-You can do a HTTP POST request to `/gms/aspects?action=restoreIndices` endpoint with the `urn` as part of JSON Payload to restore indices for the particular URN.
-
-```
-curl --location --request POST 'https://demo.datahubproject.io/api/gms/aspects?action=restoreIndices' \
---header 'Authorization: Bearer TOKEN' \
---header 'Content-Type: application/json' \
---data-raw '{
-    "urn": "YOUR_URN"
-}'
-```
+See [Restore Indices API](../api/restli/restore-indices.md).

metadata-service/restli-servlet-impl/src/main/java/com/linkedin/metadata/resources/entity/AspectResource.java

@@ -97,7 +97,7 @@ public Task<AnyRecord> get(@Nonnull String urnStr, @QueryParam("aspect") @Option
     return RestliUtil.toTask(() -> {
       final VersionedAspect aspect = _entityService.getVersionedAspect(urn, aspectName, version);
       if (aspect == null) {
-        throw RestliUtil.resourceNotFoundException();
+        throw RestliUtil.resourceNotFoundException(String.format("Did not find urn: %s aspect: %s version: %s", urn, aspectName, version));
       }
       return new AnyRecord(aspect.data());
     }, MetricRegistry.name(this.getClass(), "get"));

metadata-service/restli-servlet-impl/src/main/java/com/linkedin/metadata/resources/entity/EntityResource.java

@@ -162,7 +162,7 @@ public Task<AnyRecord> get(@Nonnull String urnStr,
           aspectNames == null ? Collections.emptySet() : new HashSet<>(Arrays.asList(aspectNames));
       final Entity entity = _entityService.getEntity(urn, projectedAspects);
       if (entity == null) {
-        throw RestliUtil.resourceNotFoundException();
+        throw RestliUtil.resourceNotFoundException(String.format("Did not find %s", urnStr));
       }
       return new AnyRecord(entity.data());
     }, MetricRegistry.name(this.getClass(), "get"));